Method: listPlannableProducts

Zwraca listę formatów reklam w YouTube, które można zaplanować w poszczególnych lokalizacjach z dozwolonym kierowaniem.

Lista zgłoszonych błędów: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError.

Żądanie HTTP

POST https://googleads.googleapis.com/v16:listPlannableProducts

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "plannableLocationId": string
}
Pola
plannableLocationId

string

To pole jest wymagane. Identyfikator wybranej lokalizacji na potrzeby planowania. Aby wyświetlić listę dostępnych identyfikatorów lokalizacji, które można zaplanować, użyj pola ReachPlanService.ListPlannableLocations.

Treść odpowiedzi

Odpowiedź ze wszystkimi dostępnymi usługami.

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

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

object (ProductMetadata)

Lista produktów dostępnych do planowania i powiązane z nimi metadane kierowania.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.

ProductMetadata

Metadane powiązane z dostępnym produktem, który można zaplanować.

Zapis JSON 
{
  "plannableProductName": string,
  "plannableTargeting": {
    object (PlannableTargeting)
  },
  "plannableProductCode": string
}
Pola
plannableProductName

string

Nazwa powiązana z ofertą reklamową.
plannableTargeting

object (PlannableTargeting)

Dozwolone planowane kierowanie tej usługi.
plannableProductCode

string

Kod powiązany z ofertą reklamową (np. BUMPER, TRUEVIEW_IN_STREAM). Aby wyświetlić listę dostępnych kodów produktów, które można zaplanować, użyj pola ReachPlanService.ListPlannableProducts.

PlannableTargeting

Kierowanie, w którego przypadku będą raportowane dane o ruchu.

Zapis JSON 
{
  "ageRanges": [
    enum (ReachPlanAgeRange)
  ],
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "networks": [
    enum (ReachPlanNetwork)
  ],
  "youtubeSelectLineups": [
    {
      object (YouTubeSelectLineUp)
    }
  ],
  "surfaceTargeting": {
    object (SurfaceTargetingCombinations)
  }
}
Pola
ageRanges[]

enum (ReachPlanAgeRange)

Dozwolone planowane przedziały wiekowe dla produktu, którego dane będą raportowane. Rzeczywiste kierowanie jest obliczane przez mapowanie tego przedziału wiekowego na standardowe wartości Google common.AgeRangeInfo.
genders[]

object (GenderInfo)

Dostępne płcie w ofercie reklamowej.
devices[]

object (DeviceInfo)

Urządzenia, na które można kierować ofertę reklamową. Jeśli w przypadku produktów CPM_MASTHEAD, GOOGLE_PREFERRED_BUMPER i GOOGLE_PREFERRED_SHORT kierowanie na urządzenia mobilne jest wybrane automatycznie, jest stosowane do raportowanych danych.
networks[]

enum (ReachPlanNetwork)

Sieci, na które można kierować ofertę reklamową.
youtubeSelectLineups[]

object (YouTubeSelectLineUp)

Lineupy YouTube Select, na które można kierować reklamy w ramach oferty reklamowej.
surfaceTargeting

object (SurfaceTargetingCombinations)

Kombinacje powierzchni, na które można kierować reklamy, dla oferty reklamowej.

YouTubeSelectLineUp

Planowalny lineup YouTube Select na potrzeby kierowania produktów

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

string (int64 format)

Identyfikator lineupu YouTube Select.
lineupName

string

Unikalna nazwa lineupu YouTube Select.

SurfaceTargetingCombinations

Kombinacje kierowania na platformę dostępne w przypadku oferty reklamowej.

Zapis JSON 
{
  "defaultTargeting": {
    object (SurfaceTargeting)
  },
  "availableTargetingCombinations": [
    {
      object (SurfaceTargeting)
    }
  ]
}
Pola
defaultTargeting

object (SurfaceTargeting)

Zastosowano domyślne kierowanie na powierzchnię oferty reklamowej.
availableTargetingCombinations[]

object (SurfaceTargeting)

Dostępne kombinacje miejsc docelowych dla oferty reklamowej.