Method: advertisers.reachForecast.retrievePlannableUserInterests

Recupera los públicos de Google (intereses del usuario) disponibles para la previsión.

Solicitud HTTP

GET https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/reachForecast:retrievePlannableUserInterests

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

Parámetros de ruta

Parámetros
advertiserId

string (int64 format)

Obligatorio. El ID del anunciante para el que se deben enumerar los intereses del usuario planificables.

Parámetros de consulta

Parámetros
productCategory

enum (PlannableProductCategory)

Obligatorio. La categoría de producto para la que se deben recuperar los intereses del usuario planificables.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta para reachForecast.retrievePlannableUserInterests.

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

Representación JSON 
{
  "plannableUserInterests": [
    {
      object (PlannableUserInterest)
    }
  ]
}
Campos
plannableUserInterests[]

object (PlannableUserInterest)

La lista de intereses del usuario planificables (públicos de Google).

Permisos de autorización

Requiere el siguiente permiso de OAuth:

  • https://www.googleapis.com/auth/display-video

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

PlannableUserInterest

Un interés del usuario planificable que se usa para la segmentación.

Representación JSON 
{
  "userInterestDisplayName": string,
  "userInterestPath": string,
  "userInterestType": string,
  "userInterest": {
    object (UserInterest)
  }
}
Campos
userInterestDisplayName

string

Solo salida. El nombre visible del interés, por ejemplo, "Entusiastas de las actividades al aire libre".
userInterestPath

string

Solo salida. La ruta de la categoría del interés.
userInterestType

string

Solo salida. El tipo de público, p.ej., "AFFINITY" o "IN_MARKET".
userInterest

object (UserInterest)

Solo salida. El identificador del interés del usuario.

La [productCategory][] especificada en la solicitud determina el campo propagado en el objeto.

  • [userInterestCategory][] se propaga para "YouTube".
  • [userInterestUserList][] se propaga para "Subasta abierta".

UserInterest

El identificador de un interés del usuario.

Representación JSON 
{
  "userInterestCategory": string,
  "userInterestUserList": string
}
Campos
userInterestCategory

string

Solo salida. El nombre del recurso de la categoría de interés. Se propaga cuando productCategory es "YouTube". Formato: customers/{customerId}/userInterests/{user_interest_id}
userInterestUserList

string

Solo salida. El nombre del recurso de la lista de usuarios. Se propaga cuando productCategory es "Subasta abierta". Formato: customers/{customerId}/userLists/{user_list_id}