Method: accounts.adUnits.list

Wyświetl jednostki reklamowe na wybranym 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

To pole jest 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 zwracanych jednostek reklamowych. Jeśli wartość nie jest określona lub ma wartość 0, zwróconych zostanie maksymalnie 10 000 jednostek reklamowych. Maksymalna wartość to 20 000, a wartości powyżej 20 000 zostaną zmienione na 20 000.
pageToken

string

Wartość zwrócona przez ostatnie ListAdUnitsResponse; wskazuje, że jest to kontynuacja poprzedniego wywołania adUnits.list i system powinien zwrócić kolejną stronę danych.

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)

Otrzymane jednostki reklamowe dla żądanego konta.
nextPageToken

string

Jeśli pole nie jest puste, wskazuje, że może być więcej jednostek reklamowych dla żądania. Ta wartość należy przekazać w nowym obiekcie 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 tej jednostki reklamowej. Format to accounts/{publisherId}/adUnits/{ad_unit_id_fragment} Przykład: accounts/pub-9876543210987654/adUnits/0123456789
adUnitId

string

Widoczny zewnętrznie identyfikator jednostki reklamowej, który umożliwia integrację z pakietem AdMob SDK. Ta właściwość jest tylko do odczytu. Przykład: ca-app-pub-9876543210987654/0123456789
appId

string

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

string

Wyświetlana przez użytkownika nazwa jednostki reklamowej widoczna 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 nie 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 otrzymuje wywołanie zwrotne weryfikujące wyświetlenie, dzięki czemu użytkownik może otrzymać nagrodę. Obsługiwane typy reklam to „RICH_MEDIA” (interaktywna) i reklamy wideo, w przypadku których nie można wykluczyć wideo. „REWARDED_INTERSTITIAL” – format reklamy pełnoekranowej z nagrodą. Obsługuje tylko reklamy wideo. Więcej informacji znajdziesz na stronie https://support.google.com/admob/answer/9884467.
adTypes[]

string

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

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