Method: listPlannableProducts

Zwraca listę formatów reklam w YouTube możliwych do planowania dla poszczególnych lokalizacji z dozwolonym kierowaniem.

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

Żądanie HTTP

POST https://googleads.googleapis.com/v15: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 do planowania. Aby wyświetlić listę dostępnych identyfikatorów lokalizacji, które można planować, użyj pola ReachPlanService.ListPlannableLocations.

Treść odpowiedzi

Odpowiedź ze wszystkimi dostępnymi produktami.

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 artykule Omówienie 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 planować, 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 w przypadku usługi, której dane będą raportowane. Rzeczywiste kierowanie jest obliczane przez mapowanie tego przedziału wiekowego na standardowe wartości Googlecommon.AgeRangeInfo.
genders[]

object (GenderInfo)

Płeć, na którą można kierować reklamy 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 wybierzesz kierowanie na urządzenia MOBILNE, w raportach jest automatycznie stosowane kierowanie na urządzenia typu TABLET.
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

Planowany lineup YouTube Select do 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 powierzchnię dostępne w przypadku danej 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.