Method: advertisers.adAssets.list

Wyświetla listę komponentów reklamy pod identyfikatorem reklamodawcy.

thought Obsługuje tylko pobieranie zasobów typu AdAssetType AD_ASSET_TYPE_YOUTUBE_VIDEO.

Żądanie HTTP

GET https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}/adAssets

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
advertiserId

string (int64 format)

Wymagane. Identyfikator reklamodawcy, do którego należą komponenty reklamy.

Parametry zapytania

Parametry
pageSize

integer

Opcjonalnie: Żądany rozmiar strony. Musi należeć do przedziału od 1 do 5000. Jeśli nie zostanie określony, domyślnie będzie to 5000. 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 przez poprzednie wywołanie metody adAssets.list. Jeśli nie zostanie określona, zwrócona zostanie pierwsza strona wyników.
orderBy

string

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

  • entityStatus
  • youtubeVideoAsset.youtubeVideoId
  • adAssetId (domyślnie)

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

string

Opcjonalnie: Umożliwia filtrowanie wyników według pól komponentów reklamy.

Obsługiwana składnia:

  • Ograniczenie ma postać {field} {operator} {value}.
  • Wszystkie pola muszą używać operatora EQUALS (=).

Obsługiwane pola:

  • youtubeVideoAsset.youtubeVideoId
  • entityStatus

Przykłady:

  • Wszystkie aktywne komponenty reklam wideo na YouTube u reklamodawcy: entityStatus=ENTITY_STATUS_ACTIVE

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Wiadomość z odpowiedzią dla: adAssets.list.

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

Zapis JSON 
{
  "adAssets": [
    {
      object (AdAsset)
    }
  ],
  "nextPageToken": string
}
Pola
adAssets[]

object (AdAsset)

Lista komponentów reklamy. Lista będzie zawierać tylko zasoby typu AdAssetType AD_ASSET_TYPE_YOUTUBE_VIDEO.

Jeśli ta lista jest pusta, nie będzie widoczna.
nextPageToken

string

Token do pobierania następnej strony wyników. Przekaż tę wartość w polu pageToken w kolejnym wywołaniu metody adAssets.list, aby pobrać następną stronę wyników.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.