Method: exchanges.publishers.list

Muestra una lista de los publicadores.

Solicitud HTTP

GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*}/publishers

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es el nombre del recurso superior. Ejemplo: exchanges/123.

Parámetros de consulta

Parámetros
pageSize

integer

Opcional. La cantidad máxima de elementos que se mostrarán. El valor máximo permitido es 50. Si no se especifica o es superior a 50, se usará 50 como tamaño de página.

pageToken

string

Opcional. El valor nextPageToken que se muestra de una solicitud de lista previa, si existe.

filter

string

Opcional. Permite filtrar por propiedades del publicador.

Sintaxis admitida:

  • Las expresiones de filtro se componen de una o más restricciones.
  • Las restricciones se pueden combinar con los operadores lógicos AND o OR. Una secuencia de restricciones usa AND de forma implícita.
  • Una restricción tiene la forma de <field> <operator> <value>.
  • El operador debe ser EQUALS (=).
  • Campos admitidos:
    • ExternalPublisherId
    • DisplayName
    • Status

Ejemplos:

  • Obtén publicadores con el estado establecido en Activo status=DISCOVERY_OBJECT_STATUS_ACTIVE

  • Obtén publicadores con el nombre visible de display name displayName="display name"

La longitud de este campo no debe superar los 500 caracteres.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta para mostrar una lista de publicadores.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "publishers": [
    {
      object (Publisher)
    }
  ],
  "nextPageToken": string
}
Campos
publishers[]

object (Publisher)

Publicadores incluidos en la lista. Se mostrará una cantidad máxima de elementos según el campo pageSize de la solicitud.

nextPageToken

string

Token para recuperar la página siguiente de resultados o vaciar si no hay más resultados en la lista.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Para obtener más información, consulta OAuth 2.0 Overview.