- Solicitud HTTP
- Parámetros de búsqueda
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Pruébala
Se muestran los anunciantes a los que puede acceder el usuario actual.
El parámetro orderBy
define el orden.
Se requiere un solo partnerId
. No se admiten las fichas de socios cruzadas.
Solicitud HTTP
GET https://displayvideo.googleapis.com/v3/advertisers
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de consulta
Parámetros | |
---|---|
partnerId |
Obligatorio. Es el ID del socio al que deberían pertenecer todos los anunciantes recuperados. El sistema solo admite la enumeración de anunciantes para un socio por vez. |
pageSize |
Indica el tamaño de la página solicitada. Debe ser un valor entre |
pageToken |
Un token que identifica una página de resultados que el servidor debe mostrar. Por lo general, es el valor de |
orderBy |
Campo por el que se ordenará la lista. Los valores aceptables son:
El orden de clasificación predeterminado es ascendente. Para especificar el orden descendente para un campo, se debe agregar el sufijo "desc" al nombre del campo. Por ejemplo, |
filter |
Permite filtrar por campos de anunciante. Sintaxis compatible:
Campos admitidos:
Ejemplos:
La longitud de este campo no debe superar los 500 caracteres. Consulta nuestra guía de filtros de solicitudes |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si el proceso es satisfactorio, el cuerpo de la respuesta contiene datos con la siguiente estructura:
Representación JSON |
---|
{
"advertisers": [
{
object ( |
Campos | |
---|---|
advertisers[] |
Es la lista de anunciantes. Esta lista no estará disponible si está vacía. |
nextPageToken |
Un token para recuperar los resultados de la página siguiente. Pasa este valor en el campo |
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/display-video
Para obtener más información, consulta la Descripción general de OAuth 2.0.