- Solicitud HTTP
- Parámetros de búsqueda
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- ContentType
- Orden
- Estado
- Pruébala
Recupera una lista de reclamos que coinciden con los criterios de búsqueda. Puedes buscar reclamos asociados a un elemento o video específico, o que coincidan con una cadena de consulta especificada.
Solicitud HTTP
GET https://youtubepartner.googleapis.com/youtube/partner/v1/claimSearch
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de consulta
Parámetros | |
---|---|
assetId |
El parámetro |
contentType |
El parámetro |
createdAfter |
El parámetro |
createdBefore |
El parámetro |
inactiveReasons |
El parámetro |
includeThirdPartyClaims |
Si se usa junto con el parámetro |
onBehalfOfContentOwner |
El parámetro |
origin |
El parámetro |
pageToken |
El parámetro |
partnerUploaded |
El parámetro |
q |
El parámetro |
referenceId |
El parámetro |
sort |
El parámetro |
status |
El parámetro |
statusModifiedAfter |
El parámetro |
statusModifiedBefore |
El parámetro |
videoId |
El parámetro |
isVideoShortsEligible |
El parámetro |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Una lista paginada de fragmentos de reclamos que se muestran en respuesta a una llamada a claimSearch.list
.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{ "kind": string, "pageInfo": { object ( |
Campos | |
---|---|
kind |
Es el tipo de respuesta de la API. Para esta operación, el valor es |
pageInfo |
El objeto |
items[] |
Una lista de reclamos que coinciden con los criterios de la solicitud. |
nextPageToken |
El token que se puede usar como valor del parámetro |
previousPageToken |
Es el token que se puede usar como valor del parámetro |
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/youtubepartner
Para obtener más información, consulta la Descripción general de OAuth 2.0.
ContentType
Es una enumeración del tipo de contenido.
Enumeradores | |
---|---|
CONTENT_TYPE_UNSPECIFIED |
Valor predeterminado |
AUDIO |
Restringir los resultados a reclamos solo de audio |
AUDIOVISUAL |
Restringe los resultados a los reclamos audiovisuales. |
VISUAL |
Restringir los resultados a reclamos solo de video |
Ordenar
Órdenes de clasificación admitidos
Enumeradores | |
---|---|
SORT_UNSPECIFIED |
Valor predeterminado |
DATE |
Los recursos se ordenan en forma cronológica inversa (de más recientes a más antiguos) según las fechas en las que se crearon. Este valor no se aplica si el parámetro status se establece en cualquiera de los siguientes valores: appealed , disputed , pending , potential o routedForReview . |
VIEW_COUNT |
Los recursos se ordenan de mayor a menor cantidad de vistas para el contenido reclamado. Este valor no se aplica si el parámetro status se establece en cualquiera de los siguientes valores: appealed , disputed , pending , potential o routedForReview . |
Estado
Enumeración del estado del reclamo.
Enumeradores | |
---|---|
STATUS_UNSPECIFIED |
Valor predeterminado |
ACTIVE |
Restringir los resultados a los reclamos con estado activo. |
APPEALED |
Restringe los resultados a los reclamos con estado de apelación. |
DISPUTED |
Restringe los resultados a los reclamos con estado de impugnación. |
INACTIVE |
Restringe los resultados a los reclamos con estado inactivo. |
PENDING |
Restringe los resultados a los reclamos con estado pendiente. |
POTENTIAL |
Restringe los resultados a las afirmaciones con estado potencial. |
ROUTED_FOR_REVIEW |
Restringe los resultados a los reclamos que deban revisarse según una regla de política de coincidencias. |
TAKEDOWN |
Restringe los resultados a los reclamos con estado de eliminación. |
SHORT_MATCH |
Restringe los resultados a los reclamos en los que el segmento coincidente sea demasiado corto como para tener la certeza de que debe crearse. |
YOUTUBE_PARTNER |
Restringe los resultados a los reclamos sobre videos que se subieron a un canal que pertenece a un socio de YouTube. |
LOW_CONFIDENCE |
Restringe los resultados a los reclamos poco confiables por varios motivos, como una puntuación de coincidencia baja, una puntuación de confianza baja, un recuento de vistas alto, etcétera. |
YT_MONETIZATION_POLICY |
Restringe los resultados a los reclamos de terceros que se sospeche que son reclamos propios que se realizan mediante agregadores de música. Esto permite que los creadores moneticen contenido sin tener que participar en el YPP. |
RETROACTIVE_BLOCK |
Restringir los resultados a reclamos poco confiables realizados como parte del bloqueo heredado |