Method: advertisers.reachForecast.retrievePlannableProducts

Pobiera listę produktów, które można zaplanować w danej lokalizacji.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
advertiserId

string (int64 format)

Wymagane. Identyfikator reklamodawcy, dla którego mają być wyświetlane produkty, które można zaplanować.

Parametry zapytania

Parametry
plannableLocationId

string

Wymagane. Identyfikator lokalizacji, w której można zaplanować podróż.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na wywołanie reachForecast.retrievePlannableProducts

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "productMetadata": [
    {
      object (ProductMetadata)
    }
  ]
}
Pola
productMetadata[]

object (ProductMetadata)

Tylko dane wyjściowe. Lista metadanych produktu pokazująca możliwości kierowania.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.

ProductMetadata

Metadane produktu, który można zaplanować.

Zapis JSON 
{
  "plannableProductDescription": string,
  "plannableProductCode": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "displayName": string,
  "plannableProductCoreAttributes": {
    object (PlannableProductCoreAttributes)
  }
}
Pola
plannableProductDescription

string

Tylko dane wyjściowe. Opis tekstowy usługi reklamowej.
plannableProductCode

string

Tylko dane wyjściowe. Kod produktu, który można zaplanować (np. „YOUTUBE_REACH_MIX”).
plannableTargeting

object (PlannableTargeting)

Tylko dane wyjściowe. Możliwości kierowania dostępne w przypadku tej usługi.
displayName

string

Tylko dane wyjściowe. Nazwa powiązana z usługą reklamową. Na przykład „Kampania promująca obejrzenie filmu”.
plannableProductCoreAttributes

object (PlannableProductCoreAttributes)

Tylko dane wyjściowe. Podstawowe atrybuty tego produktu.

PlannableTargeting

Możliwości kierowania w przypadku danego produktu.

Zapis JSON 
{
  "ageRanges": [
    enum (PlannableAgeRange)
  ],
  "surfaceTargetingCombinations": {
    object (SurfaceTargetingCombinations)
  },
  "genders": [
    enum (Gender)
  ],
  "networks": [
    enum (PlannableNetwork)
  ],
  "devices": [
    enum (DeviceType)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "defaultYoutubeSelectLineup": {
    object (YouTubeSelectLineUp)
  }
}
Pola
ageRanges[]

enum (PlannableAgeRange)

Tylko dane wyjściowe. Dozwolone przedziały wiekowe, w których można wyświetlać reklamy produktu. Rzeczywiste kierowanie jest obliczane przez przypisanie tego przedziału wiekowego do standardowego kierowania na grupy wiekowe w Google.
surfaceTargetingCombinations

object (SurfaceTargetingCombinations)

Tylko dane wyjściowe. Kombinacje powierzchni, na których można wyświetlać reklamy.
genders[]

enum (Gender)

Tylko dane wyjściowe. Płcie, na które można kierować reklamy.
networks[]

enum (PlannableNetwork)

Tylko dane wyjściowe. Sieci, na które można kierować reklamy.
devices[]

enum (DeviceType)

Tylko dane wyjściowe. Urządzenia, na których można wyświetlać reklamy.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

Tylko dane wyjściowe. Lineupy YouTube Select, na które można kierować reklamy w przypadku danego produktu reklamowego.
defaultYoutubeSelectLineup

object (YouTubeSelectLineUp)

Tylko dane wyjściowe. Domyślna lista YouTube Select dla tego produktu (w odpowiednich przypadkach).

SurfaceTargetingCombinations

Reguły kierowania na platformę.

Zapis JSON 
{
  "availableSurfaceTypes": [
    enum (PlannableSurface)
  ],
  "validSurfaceCombinations": [
    {
      object (SurfaceTargetingCombination)
    }
  ],
  "defaultSurfaceTypes": [
    enum (PlannableSurface)
  ]
}
Pola
availableSurfaceTypes[]

enum (PlannableSurface)

Tylko dane wyjściowe. Dostępne typy platform.
validSurfaceCombinations[]

object (SurfaceTargetingCombination)

Tylko dane wyjściowe. Prawidłowe kombinacje platform, które można wybrać razem.
defaultSurfaceTypes[]

enum (PlannableSurface)

Tylko dane wyjściowe. Domyślne typy platform dla tego produktu.

SurfaceTargetingCombination

prawidłową kombinację platform.

Zapis JSON 
{
  "choices": [
    enum (PlannableSurface)
  ]
}
Pola
choices[]

enum (PlannableSurface)

Tylko dane wyjściowe. Kombinacja platform.

YouTubeSelectLineUp

Planowany lineup YouTube Select do kierowania na produkty.

Zapis JSON 
{
  "lineupId": string,
  "displayName": string
}
Pola
lineupId

string (int64 format)

Tylko dane wyjściowe. Identyfikator lineupu YouTube Select.
displayName

string

Tylko dane wyjściowe. Wyświetlana nazwa pakietu YouTube Select.

PlannableProductCoreAttributes

Podstawowe atrybuty produktu, który można zaplanować.

Zapis JSON 
{
  "productCategory": enum (PlannableProductCategory),
  "buyingMethod": enum (PlannableBuyingMethod),
  "costModel": enum (PlannableCostModel)
}
Pola
productCategory

enum (PlannableProductCategory)

Tylko dane wyjściowe. Kategoria produktu.
buyingMethod

enum (PlannableBuyingMethod)

Tylko dane wyjściowe. Metoda zakupu.
costModel

enum (PlannableCostModel)

Tylko dane wyjściowe. Model kosztów.

PlannableBuyingMethod

Metoda zakupu produktu, który można zaplanować.

Wartości w polu enum
PLANNABLE_BUYING_METHOD_UNSPECIFIED Nie określono.
PLANNABLE_BUYING_METHOD_AUCTION Aukcja.
PLANNABLE_BUYING_METHOD_RESERVATION Rezerwacja.

PlannableCostModel

Model kosztów produktu, który można zaplanować.

Wartości w polu enum
PLANNABLE_COST_MODEL_UNSPECIFIED Nie określono.
PLANNABLE_COST_MODEL_CPM CPM”.
PLANNABLE_COST_MODEL_CPV CPV.
PLANNABLE_COST_MODEL_CPC CPC.
PLANNABLE_COST_MODEL_CPA stawki CPA.