Method: sellers.adUnits.list

Muestra una lista de las unidades de anuncios.

  • Por ejemplo: GET /v1/sellers/seller111/adUnits
  • Muestra una lista de unidades de anuncios y un token para recuperar la página siguiente si se realiza correctamente.
  • Muestra el código de error PERMISSION_DENIED si el usuario no tiene acceso al vendedor o no existe un ID de vendedor.
  • Muestra el código de error INVALID_ARGUMENT si los vendedores proporcionan un tamaño de página o un token de página no válidos.

Solicitud HTTP

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adUnits

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

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El vendedor, propietario de esta colección de unidades de anuncios. Formato: vendedores/{seller}

Parámetros de consulta

Parámetros
pageSize

integer

La cantidad máxima de elementos que se mostrarán. El servicio puede mostrar menos que este valor. La cantidad máxima permitida de unidades de anuncios es 1,000. los valores superiores a 1,000 se cambiarán a 1,000. Si no se especifica, se mostrarán 1,000 unidades de anuncios como máximo.
pageToken

string

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

string

El filtro de lista. Actualmente es compatible con el filtrado de estado y de ID externo, con la sintaxis “externalId = [EXTERNAL_ID]”. y "estado = [STATE]". Los operadores lógicos AND y OR se pueden usar para encadenar filtros. No se puede usar AD_UNIT_STATE_DELETED para mostrar unidades de anuncios eliminadas. En su lugar, usa showDeleted.
orderBy

string

Es el orden por cadena que se usa para especificar la clasificación de los resultados. Actualmente, se admiten pedidos realizados a través de updateTime, por lo que debes proporcionar "updateTime". para obtener resultados ordenados por updateTime en orden ascendente o "updateTime desc" para el orden descendente.
showDeleted

boolean

Indica si se deben mostrar los bloques de anuncios borrados de forma no definitiva.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

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

Mensaje de respuesta para InventoryService.ListAdUnits.

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

object (AdUnit)

Es la lista de unidades de anuncios.
nextPageToken

string

Un token para recuperar los resultados de la página siguiente. Pasa este valor en el campo pageToken en la llamada posterior al método adUnits.list para recuperar la siguiente página de resultados.

Alcances de la autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la descripción general de OAuth 2.0.