Method: advertisers.adGroups.targetingTypes.assignedTargetingOptions.list

Zawiera listę opcji kierowania przypisanych do grupy reklam.

Nie są uwzględniane odziedziczone przypisane opcje kierowania.

Żądanie HTTP

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/adGroups/{adGroupId}/targetingTypes/{targetingType}/assignedTargetingOptions

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
advertiserId

string (int64 format)

Wymagane. Identyfikator reklamodawcy, do którego należy grupa reklam.
adGroupId

string (int64 format)

Wymagane. Identyfikator grupy reklam, dla której chcesz wyświetlić przypisane opcje kierowania.
targetingType

enum (TargetingType)

Wymagane. Określa typ przypisanych opcji kierowania, które mają być wyświetlane na liście.

Obsługiwane typy kierowania:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SESSION_POSITION
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO

Parametry zapytania

Parametry
pageSize

integer

Opcjonalnie: Żądany rozmiar strony. Musi należeć do przedziału od 1 do 5000. Jeśli nie podasz tu żadnej wartości, zostanie użyta wartość domyślna 100. Jeśli podano nieprawidłową wartość, zwraca kod błędu INVALID_ARGUMENT.
pageToken

string

Opcjonalnie: Token identyfikujący stronę wyników, którą serwer powinien zwrócić. Zwykle jest to wartość nextPageToken zwrócona z poprzedniego wywołania metody assignedTargetingOptions.list. Jeśli nie zostanie określona, zwracana jest pierwsza strona wyników.
orderBy

string

Opcjonalnie: Pole, według którego ma być posortowana lista. Akceptowane wartości:

  • assignedTargetingOptionId (domyślnie)

Domyślna kolejność sortowania to rosnąca. Aby określić kolejność malejącą dla pola, do nazwy pola należy dodać sufiks „desc”. Przykład: assignedTargetingOptionId desc.
filter

string

Opcjonalnie: Umożliwia filtrowanie według przypisanych pól opcji kierowania.

Obsługiwana składnia:

  • Wyrażenia filtra składają się z co najmniej 1 ograniczenia.
  • Ograniczenia można łączyć za pomocą operatora logicznego OR.
  • Ograniczenie ma postać {field} {operator} {value}.
  • Wszystkie pola muszą używać operatora EQUALS (=).

Obsługiwane pola:

  • assignedTargetingOptionId

Przykłady:

  • AssignedTargetingOption zasoby o identyfikatorze 1 lub 2: assignedTargetingOptionId="1" OR assignedTargetingOptionId="2"

Długość tego pola nie powinna przekraczać 500 znaków.

Więcej informacji znajdziesz w przewodniku filtrowanie żądań.LIST

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Wiadomość z odpowiedzią dla assignedTargetingOptions.list.

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

Zapis JSON 
{
  "assignedTargetingOptions": [
    {
      object (AssignedTargetingOption)
    }
  ],
  "nextPageToken": string
}
Pola
assignedTargetingOptions[]

object (AssignedTargetingOption)

Lista przypisanych opcji kierowania.

Jeśli lista jest pusta, nie będzie jej w odpowiedzi.
nextPageToken

string

Token identyfikujący następną stronę wyników. Ta wartość powinna być określona jako pageToken w kolejnym żądaniu ListAdGroupAssignedTargetingOptionsRequest, aby pobrać następną stronę wyników. Jeśli nie ma już więcej zasobów AssignedTargetingOption do zwrócenia, ten token nie będzie obecny.

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.