- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- AdUnit
- Przykłady
- Wypróbuj
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 |
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 |
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 |
Wartość zwrócona przez ostatnie |
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 ( |
Pola | |
---|---|
adUnits[] |
Otrzymane jednostki reklamowe dla żądanego konta. |
nextPageToken |
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 |
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 |
Nazwa zasobu tej jednostki reklamowej. Format to accounts/{publisherId}/adUnits/{ad_unit_id_fragment} Przykład: accounts/pub-9876543210987654/adUnits/0123456789 |
adUnitId |
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 |
Widoczny zewnętrznie identyfikator aplikacji, z którą jest powiązana ta jednostka reklamowa. Przykład: ca-app-pub-9876543210987654~0123456789 |
displayName |
Wyświetlana przez użytkownika nazwa jednostki reklamowej widoczna w interfejsie AdMob. Maksymalna dozwolona długość to 80 znaków. |
adFormat |
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[] |
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. |