Ta strona została przetłumaczona przez Cloud Translation API.

Informacje o wersjach

Ta strona zawiera informacje o wersji interfejsu AdSense Management API.

Wersja 2

W tej wersji wprowadziliśmy opisane poniżej zmiany, które mają na celu usunięcie wycofanych funkcji i zapewnienie zgodności interfejsu AdSense Management API z aktualnymi standardami interfejsów API Google. Zgodnie z schematem obsługi wersji interfejsów API Google ta wersja będzie z czasem aktualizowana o dodatkowe (zgodne wstecznie) funkcje zamiast nowych funkcji udostępnianych w osobnych wersjach podrzędnych.

2023-06-19

Płatności

payments.list zawiera teraz szczegóły płatności dla wydawców premium.

2023-06-13

Raporty

Dodaliśmy dane FUNNEL_REQUESTS, FUNNEL_IMPRESSIONS, FUNNEL_CLICKS i FUNNEL_RPM, które dostarczają informacji o skuteczności jednostek innych niż jednostki reklamowe (np. jednostek podobnego wyszukiwania).

2023-03-30

Raporty

Dodano wymiar PAGE_URL, który umożliwia podzielenie danych według adresu URL strony (z pewnymi zastrzeżeniami: patrz Podział adresów URL stron).

2022-09-21

AdUnits

Dodano metody tworzenia i poprawki. Pamiętaj, że tych metod mogą używać tylko projekty z włączoną usługą AdSense dla platform.

CustomChannels

Dodano metody tworzenia, poprawek i aktualizacji. Pamiętaj, że tych metod mogą używać tylko projekty z włączoną usługą AdSense dla platform.
Aktywne pole zostało dodane do zasobu.

Konta

Dodano metodę getAdBlockRecoveryTag.

2022-08-25

Raporty

Dodaliśmy wymiar HOSTED_AD_CLIENT_ID, który umożliwia wydawcom hostującym i platformom podział danych według kont wydawców (wydawców hostujących) i subkont (wydawców platformy).

2022-05-03

AdClient

Dodano metodę get.

Raporty

Dodano metodę getSaved.

UrlChannels

Dodano metodę get.

2022-03-31

Konto

Nieaktywne konta są teraz zwracane przez interfejs API, a pole state wskazuje stan konta.

AdClient

Podobnie jak w przypadku powyższych zmian na koncie, nieaktywne klienty reklam są teraz zwracane przez interfejs API z polem state wskazującym stan klienta reklamowego.

2022-02-24

Płatność

Format nazwy zasobu został rozszerzony, aby obsługiwać osobne zasoby dotyczące zarobków z YouTube. Ta zmiana nastąpi przed stopniowym wdrożeniem ulepszonej wersji AdSense dla twórców YouTube, w której zarobki z YouTube będą rozdzielane na oddzielne konto płatności. Dane do płatności z YouTube będą też zwracane z formy listy płatności, gdy będziesz mieć specjalne konto płatności do zarobków z YouTube. Zarobki z YouTube będą miały następujący format nazwy zasobu:
- accounts/{account}/payments/youtube-unpaid za niewypłacone (bieżące) zarobki z YouTube.
- accounts/{account}/payments/youtube-yyyy-MM-dd dla wypłaconych zarobków z YouTube.
Uwaga: nazwy zasobów zarobków z AdSense pozostają bez zmian:
- accounts/{account}/payments/unpaid (niewypłacone (bieżące) zarobki z AdSense).
- accounts/{account}/payments/yyyy-MM-dd dotyczące wypłaconych zarobków z AdSense.

2021-06-30

Raport

Dodano wymiary AD_FORMAT_NAME i AD_FORMAT_CODE wskazujące sposób wyświetlania reklamy użytkownikom w Twojej witrynie (na stronie, w reklamie winietowej itp.). Pamiętaj, że w wersji 1.4 wymiary zostały (wycofane) o tych samych nazwach, ale o różnych elementach składowych. Dwa wymiary dodane w wersji 2 różnią się od tych z wersji 1.4.

19.04.2021 (pierwsza wersja)

Ogólne

Wszystkie wycofane metody w wersji 1.4 zostały usunięte. Obejmuje to metody zasobów, które nie wymagały obiektu accountId. W wersji 2 właściwość accountId jest określona w polu parent.
Zgodnie ze standardami interfejsów API Google zasoby są teraz identyfikowane polem name. Na przykład nazwa klienta AdClient będzie wyglądać tak: accounts/{accountId}/adclients/{adClientId}. Dodatkowo w wersji 1.4 identyfikator zasobu był używany jako wymiar raportowania, ale w wersji 2 ta wartość jest teraz dostępna w polu reporting_dimension_id w kilku zasobach.
Pole kind zostało usunięte ze wszystkich zasobów.

Konto

Pole name zostało zmienione na display_name.
Pole timezone zostało zmienione z ciągu znaków na google.type.TimeZone.
Pole creation_time (typ int64) zostało zmienione na create_time (typ google.protobuf.Timestamp).
Dodaliśmy pole pending_tasks z listą zaległych zadań, które należy wykonać w ramach procesu rejestracji nowego konta. Mogą to być na przykład zadania związane z profilem płatności lub weryfikacją telefoniczną.
Pole sub_accounts zostało usunięte. Podobną funkcjonalność w wersji 2 można uzyskać za pomocą niestandardowej metody listChildAccounts. Pełne drzewo konta podrzędnego można wygenerować w wersji 2 przy użyciu rekurencyjnego wywołania listChildAccounts.

AdClient

Usunęliśmy pole arc_opt_in, ponieważ zostało już usunięte z interfejsu AdSense.
Pole supports_reporting zostanie zastąpione polem reporting_dimension_id, które reprezentuje unikalny identyfikator klienta reklamy używanego w wymiarze raportowania AD_CLIENT_ID. Jeśli pole reporting_dimension_id jest puste, AdClient nie obsługuje raportowania.

AdUnit

Nazwa pola status została zmieniona na state. Stan ACTIVE nie wskazuje już też, czy w ciągu ostatnich 7 dni wystąpiła aktywność dotycząca tej jednostki reklamowej. W wersji 2 oznacza to, że jednostka reklamowa została aktywowana przez użytkownika i może wyświetlać reklamy.
Pole code zostało usunięte. Tę wartość nadal znajdziesz na końcu pola name (po ostatnim ukośniku).
Pole contentAdsSettings.backupOption zostało usunięte.
Pole type zostało ograniczone do wartości TYPE_UNSPECIFIED, DISPLAY, FEED, ARTICLE, MATCHED_CONTENT i LINK.
Zostaną też usunięte inne pola, które zostały już usunięte z interfejsu AdSense: custom_style, saved_style_id, mobile_content_ads_settings, feed_ads_settings.

Alert

Metoda delete została usunięta.
Pole is_dismissible zostało usunięte.
Nazwa pola locale została zmieniona na language_code.

CustomChannel

Pole code zostało usunięte. Tę wartość nadal znajdziesz na końcu pola name (po ostatnim ukośniku).
Pole targeting_info zostało usunięte, ponieważ zostało usunięte z interfejsu AdSense.

Płatność

Nazwa pola payment_date została zmieniona na date i została zmieniona z ciągu typu na google.type.Date.
Pole payment_amount i pole payment_amount_currency_code zostały połączone w jedno pole payment (np. „1235 JPY”, „1234,57 PLN”, „87,65 PLN”).

Raport

W wersji 2 dane raportowania interfejsu API do zarządzania AdSense są teraz zgodne z danymi w interfejsie użytkownika AdSense. Oznacza to, że usługi AdMob i YouTube nie są już obsługiwane. Poza tym interfejs API obsługuje tylko dane z ostatnich 3 lat.
Zasób Metadata.dimensions i zasób Metadata.metrics zostały usunięte.
Dodaliśmy nowe metody generowania raportu w wersji CSV, które zastąpiły parametry zapytania w wersji 1.4. Uwaga: w przypadku kompresji możesz nadal używać nagłówka HTTP „Accept-Encoding: gzip”.
Niektóre pola zostały zmienione podczas doraźnego generowania raportu.
- Nazwa pola account_id została zmieniona na account.
- Nazwa pola dimension została zmieniona na dimensions.
- Nazwa pola metric została zmieniona na metrics.
- Nazwa pola filter została zmieniona na filters.
- Nazwa pola sort została zmieniona na order_by.
- Nazwa pola locale została zmieniona na language_code.
- Nazwa pola currency została zmieniona na currency_code.
- Za pomocą funkcji date_range możesz teraz określić kilka typowych zakresów (np. TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS i LAST_30_DAYS) albo możesz określić start_date i end_date, ustawiając date_range na CUSTOM.
- Pola start_date i end_date zostały zmienione z ciągu znaków typu na typ google.type.Date. Uwaga: w rezultacie uwzględnianie słów kluczowych powiązanych z datami (np. „today-6d”) nie są już obsługiwane.
- Pole wartości logicznej use_timezone_reporting zostało zastąpione wartością reporting_time_zone, która może mieć jedną z 2 wartości: ACCOUNT_TIME_ZONE lub GOOGLE_TIME_ZONE (oznacza PST/PDT). Wartością domyślną w wersji 2 jest ACCOUNT_TIME_ZONE. Różni się ona od ustawienia domyślnego w wersji 1.4.
- Pole start_index zostało usunięte.
- Nazwa pola max_results została zmieniona na limit.
Niektóre pola zostały zmienione podczas generowania zapisanego raportu.
- Dodano pola daty (date_range, start_date, end_date, reporting_time_zone).
- Dodano pole currency_code.
- Nazwa pola locale została zmieniona na language_code.
- Pole start_index zostało usunięte.
- Pole max_results zostało usunięte.

SavedAdStyle

Identyfikator SavedAdStyle został usunięty, ponieważ został już usunięty z interfejsu AdSense.

Witryna

Rozszerzenie Sites zostało dodane, aby umożliwić pobieranie danych o witrynach dodanych do Twojego konta AdSense.
Pole state wskazuje, czy witryna ma jeden z tych stanów: REQUIRES_REVIEW, GETTING_READY, READY, NEEDS_ATTENTION.
Pole auto_ads_enabled zawiera wartość logiczną, która wskazuje, czy reklamy automatyczne zostały włączone w konkretnej witrynie.