Adunits.customchannels: list

Requiere autorización

Enumera todos los canales personalizados a los que pertenece el bloque de anuncios especificado. Pruébalo ahora.

Solicitud

Solicitud HTTP

GET https://www.googleapis.com/adsense/v1.4/adclients/adClientId/adunits/adUnitId/customchannels

Parámetros

Nombre de parámetro Valor Descripción
Parámetros de ruta
adClientId string Cliente publicitario que contiene el bloque de anuncios.
adUnitId string Bloque de anuncios del que se enumerarán los canales personalizados.
Parámetros de consulta opcionales
maxResults integer Número máximo de canales personalizados que se incluirán en la respuesta. Se utiliza para la paginación. Los valores aceptables son de 0 a 10000, ambos incluidos.
pageToken string Token de continuación, que se utiliza para navegar por los criterios de seguimiento personalizados. Para recuperar la página siguiente, configure este parámetro con el valor "nextPageToken" de la respuesta anterior.

Autorización

Esta solicitud requiere autorización con al menos uno de los siguientes alcances (más información sobre la autenticación y la autorización).

Alcance
https://www.googleapis.com/auth/adsense
https://www.googleapis.com/auth/adsense.readonly

Cuerpo de la solicitud

No proporciones un cuerpo de solicitud con este método.

Respuesta

Si este método se realiza correctamente, el cuerpo de respuesta tendrá la siguiente estructura:

{
  "kind": "adsense#customChannels",
  "etag": etag,
  "nextPageToken": string,
  "items": [
    {
      "kind": "adsense#customChannel",
      "id": string,
      "code": string,
      "name": string,
      "targetingInfo": {
        "adsAppearOn": string,
        "location": string,
        "description": string,
        "siteLanguage": string
      }
    }
  ]
}
Nombre de propiedad Valor Descripción Notas
kind string Indica el tipo de lista, en este caso adsense#customChannels.
etag etag Elemento etag de esta respuesta para fines de almacenamiento en caché.
nextPageToken string Token de continuación, que se utiliza para la separación en páginas de los canales personalizados. Para recuperar la siguiente página de resultados, establece el valor "pageToken" de la siguiente solicitud con este valor.
items[] list Canales personalizados devueltos en esta respuesta de lista.
items[].kind string Indica el tipo de recurso, en este caso adsense#customChannel.
items[].id string Identificador único de este canal personalizado. Se debe considerar un identificador opaco; no se puede confiar en que esté en un determinado formato.
items[].code string Código de este canal personalizado, que no necesariamente tiene que ser único entre los clientes publicitarios.
items[].name string Nombre de este canal personalizado.
items[].targetingInfo object Información de orientación de este canal personalizado, si está activada.
items[].targetingInfo.adsAppearOn string Nombre que se usa para describir este canal de forma externa.
items[].targetingInfo.location string Ubicaciones en las que aparecen los anuncios. Solo es válido para los anuncios de contenido y los anuncios de contenido para móviles. Los valores aceptables para los anuncios de la Red de Display son: TOP_LEFT, TOP_CENTER, TOP_RIGHT, MIDDLE_LEFT, MIDDLE_CENTER, MIDDLE_RIGHT, BOTTOM_LEFT, BOTTOM_CENTER, BOTTOM_RIGHT, MULTIPLE_LOCATIONS. Los valores aceptables para los anuncios de la Red de Display para móviles son: TOP, MIDDLE, BOTTOM, MULTIPLE_LOCATIONS.

Los valores posibles son:
  • "BOTTOM":
  • "BOTTOM_CENTER":
  • "BOTTOM_LEFT":
  • "BOTTOM_RIGHT":
  • "MIDDLE":
  • "MIDDLE_CENTER":
  • "MIDDLE_LEFT":
  • "MIDDLE_RIGHT":
  • "MULTIPLE_LOCATIONS":
  • "TOP":
  • "TOP_CENTER":
  • "TOP_LEFT":
  • "TOP_RIGHT":
items[].targetingInfo.description string Descripción externa del canal.
items[].targetingInfo.siteLanguage string Idioma de los sitios en el que se mostrarán los anuncios.

Pruébalo

Utiliza el siguiente explorador de APIs para llamar a este método con datos en tiempo real y ver la respuesta.