Method: advertisers.reachForecast.retrievePlannableUserInterests

Recupera i segmenti di pubblico Google (interessi degli utenti) disponibili per la previsione.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
advertiserId

string (int64 format)

Obbligatorio. L'ID dell'inserzionista per cui elencare gli interessi degli utenti pianificabili.

Parametri di query

Parametri
productCategory

enum (PlannableProductCategory)

Obbligatorio. La categoria di prodotto per cui recuperare gli interessi degli utenti pianificabili.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta per reachForecast.retrievePlannableUserInterests.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "plannableUserInterests": [
    {
      object (PlannableUserInterest)
    }
  ]
}
Campi
plannableUserInterests[]

object (PlannableUserInterest)

L'elenco degli interessi degli utenti pianificabili (segmenti di pubblico Google).

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.

PlannableUserInterest

Un interesse dell'utente pianificabile utilizzato per il targeting.

Rappresentazione JSON 
{
  "userInterestDisplayName": string,
  "userInterestPath": string,
  "userInterestType": string,
  "userInterest": {
    object (UserInterest)
  }
}
Campi
userInterestDisplayName

string

Solo output. Il nome visualizzato dell'interesse, ad esempio "Appassionati di attività all'aperto".
userInterestPath

string

Solo output. Il percorso della categoria dell'interesse.
userInterestType

string

Solo output. Il tipo di pubblico, ad esempio "AFFINITY", "IN_MARKET".
userInterest

object (UserInterest)

Solo output. L'identificatore dell'interesse dell'utente.

Il campo [productCategory][] specificato nella richiesta determina il campo compilato nell'oggetto.

  • [userInterestCategory][] è compilato per "YouTube".
  • [userInterestUserList][] viene compilato per "Asta aperta".

Interesse utente

L'identificatore di un interesse dell'utente.

Rappresentazione JSON 
{
  "userInterestCategory": string,
  "userInterestUserList": string
}
Campi
userInterestCategory

string

Solo output. Il nome della risorsa della categoria di interessi. Viene compilato quando productCategory è "YouTube". Formato: customers/{customerId}/userInterests/{user_interest_id}
userInterestUserList

string

Solo output. Il nome risorsa dell'elenco utenti. Viene compilato quando productCategory è "Asta aperta". Formato: customers/{customerId}/userLists/{user_list_id}