Method: accounts.adUnits.list

Wyświetl listę jednostek reklamowych na określonym koncie AdMob.

Żądanie HTTP

GET https://admob.googleapis.com/v1/{parent=accounts/*}/adUnits

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Nazwa zasobu konta, dla którego mają zostać wyświetlone jednostki reklamowe. Przykład: accounts/pub-9876543210987654

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba jednostek reklamowych do zwrócenia. Jeśli nie podasz wartości lub podasz 0, zwrócimy maksymalnie 10 tys. jednostek reklamowych. Maksymalna wartość to 20 000. Wartości powyżej 20 000 zostaną ograniczone do 20 000.
pageToken

string

Wartość zwrócona przez ostatni znak ListAdUnitsResponse; wskazuje, że jest to kontynuacja poprzedniego wywołania ListAdUnitsResponse, a system powinien zwrócić następną stronę danych.adUnits.list

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na żądanie listy jednostek reklamowych.

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

Zapis JSON 
{
  "adUnits": [
    {
      object (AdUnit)
    }
  ],
  "nextPageToken": string
}
Pola
adUnits[]

object (AdUnit)

Jednostki reklamowe na koncie, którego dotyczy żądanie.
nextPageToken

string

Jeśli nie jest pusta, oznacza, że w żądaniu może być więcej jednostek reklamowych. Tę wartość należy przekazać w nowym żądaniu ListAdUnitsRequest.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/admob.readonly

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.

AdUnit

Opisuje jednostkę reklamową AdMob.

Zapis JSON 
{
  "name": string,
  "adUnitId": string,
  "appId": string,
  "displayName": string,
  "adFormat": string,
  "adTypes": [
    string
  ]
}
Pola
name

string

Nazwa zasobu tej jednostki reklamowej. Format to accounts/{publisherId}/adUnits/{ad_unit_id_fragment}. Przykład: accounts/pub-9876543210987654/adUnits/0123456789
adUnitId

string

Widoczny na zewnątrz identyfikator jednostki reklamowej, którego można używać do integracji z pakietem AdMob SDK. Jest to właściwość tylko do odczytu. Przykład: ca-app-pub-9876543210987654/0123456789
appId

string

Widoczny na zewnątrz identyfikator aplikacji, z którą powiązana jest ta jednostka reklamowa. Przykład: ca-app-pub-9876543210987654~0123456789
displayName

string

Nazwa wyświetlana jednostki reklamowej widoczna w interfejsie AdMob, podana przez użytkownika. Maksymalna dozwolona długość to 80 znaków.
adFormat

string

Format reklamy jednostki reklamowej. Możliwe wartości:

„APP_OPEN” – format reklamy przy otwarciu aplikacji. „BANNER” – format reklamy banerowej. „BANNER_INTERSTITIAL” – starszy format, który może być używany jako baner lub reklama pełnoekranowa. Nie można już tworzyć tego formatu, ale grupy mediacji mogą na niego kierować reklamy. „INTERSTITIAL” – reklama pełnoekranowa. Obsługiwane typy reklam to „RICH_MEDIA” i „VIDEO”. „NATIVE” – format reklamy natywnej. „REWARDED” – reklama, która po wyświetleniu wywołuje zwrotne potwierdzenie wyświetlenia, dzięki czemu użytkownik może otrzymać nagrodę. Obsługiwane typy reklam to „RICH_MEDIA” (interaktywne) i reklamy wideo, których nie można wykluczyć. „REWARDED_INTERSTITIAL” – format reklamy pełnoekranowej z nagrodą. Obsługuje tylko typ reklamy wideo. Więcej informacji znajdziesz na stronie https://support.google.com/admob/answer/9884467.
adTypes[]

string

Typ mediów w reklamie obsługiwany przez tę jednostkę reklamową. Możliwe wartości:

„RICH_MEDIA” – tekst, obraz i inne multimedia inne niż wideo. „VIDEO” – multimedia wideo.