Method: accounts.adUnits.list

Wyświetl jednostki reklamowe powiązane z określonym kontem 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 chcesz wyświetlić listę jednostek reklamowych. Przykład: accounts/pub-9876543210987654

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba jednostek reklamowych do zwrotu. Jeśli wartość nie jest określona lub ma wartość 0, zwróconych zostanie maksymalnie 10 000 jednostek reklamowych. Maksymalna wartość to 20 000. wartości powyżej 20 000 zostaną zmienione na 20 000.
pageToken

string

Wartość zwracana przez ostatnie działanie funkcji ListAdUnitsResponse; wskazuje, że jest to kontynuacja poprzedniego wywołania funkcji adUnits.list i że system powinien zwrócić następną stronę danych.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na żądanie wyświetlenia 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)

Utworzone jednostki reklamowe dla żądanego konta.
nextPageToken

string

Jeśli brak wartości, oznacza, że dla żądania może być więcej jednostek reklamowych. tę wartość należy przekazać w nowym formacie ListAdUnitsRequest.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.

AdUnit

Opisuje jednostkę reklamową AdMob.

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

string

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

string

Widoczny z zewnątrz identyfikator jednostki reklamowej, którego można użyć do integracji z pakietem SDK AdMob. Ta usługa jest dostępna tylko do odczytu. Przykład: ca-app-pub-9876543210987654/0123456789
appId

string

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

string

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

string

AdFormat jednostki reklamowej. Możliwe wartości:

„APP_OPEN” – Format reklamy wyświetlanej przy otwarciu aplikacji. „BANNER” – Format banera reklamowego. „BANNER_INTERSTITIAL” – Starszy format, który może być używany jako baner lub reklama pełnoekranowa. Nie można już utworzyć tego formatu, ale grupy zapośredniczenia mogą na niego kierować. „PEŁNOEKRANOWE” - reklama pełnoekranowa. Obsługiwane typy reklam to „RICH_MEDIA” i „WIDEO”. „NATIVE” – Format reklamy natywnej. „Z NAGRODĄ” – reklama, która po wyświetleniu otrzymuje wywołanie zwrotne w celu weryfikacji wyświetlenia, dzięki czemu użytkownik może otrzymać nagrodę. Obsługiwane typy reklam to „RICH_MEDIA” (interaktywny) oraz wideo, w przypadku których nie można wykluczyć filmu. „REWARDED_INTERSTITIAL” – Format reklamy pełnoekranowej z nagrodą. Obsługuje tylko typ reklamy wideo. Więcej informacji: https://support.google.com/admob/answer/9884467.
adTypes[]

string

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

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