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

Informacje o wersjach

Ta strona zawiera informacje o wersji interfejsu API zarządzania AdSense.

Wersja 2

W tej wersji wprowadziliśmy te zmiany, aby usunąć wycofane funkcje i dostosować interfejs API zarządzania AdSense do obecnych standardów interfejsów API Google. Zgodnie ze schematem wersji interfejsów API Google ta wersja będzie z czasem aktualizowana, aby uwzględniać dodatkowe funkcje (zgodne wstecznie), a nie nowe funkcje udostępniane w osobnych wersjach podrzędnych.

2025-10-02

Raporty

Dodaliśmy wymiar TRAFFIC_SOURCE, który umożliwia dzielenie danych według źródła wizyt (np. „Google”, „Bing”, „Facebook”, „Inne”). Więcej informacji znajdziesz w sekcji Zestawienie źródeł wizyt.

2025-05-06

PolicyIssues

Wycofane pole policyTopics[].must_fix (patrz poprzednia aktualizacja) będzie teraz zawsze ustawione na false.

2025-02-24

PolicyIssues

Dodaliśmy pole policyTopics[].type, aby określić, czy temat zasad dotyczy problemu ze zgodnością z zasadami, problemu związanego z przepisami czy ustawień reklamodawcy. Zastępuje ono pole policyTopics[].must_fix, które jest teraz oznaczone jako wycofane.

2024-04-03

PolicyIssues

Dodaliśmy nową kolekcję, która umożliwia generowanie raportów o bieżących naruszeniach zasad i ostrzeżeniach dotyczących konta.

2023-06-19

Płatności

Funkcja payments.list zwraca 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 zawierają informacje o skuteczności jednostek innych niż reklamy (np. jednostek powiązanych wyszukiwań).

2023-03-30

Raporty

Dodaliśmy wymiar PAGE_URL, który umożliwia podział danych według adresu URL strony (z pewnymi zastrzeżeniami – patrz sekcja Podział według adresu URL strony).

2022-09-21

AdUnits

Dodano metody tworzenia i stosowania poprawek. Pamiętaj, że te metody mogą być używane tylko w projektach, w których włączona jest usługa AdSense dla platform.

CustomChannels

Dodano metody tworzenia, poprawiania i aktualizowania. Pamiętaj, że te metody mogą być używane tylko w projektach, w których włączona jest usługa AdSense dla platform.
Dodano pole aktywne do zasobu.

Konta

Dodano metodę getAdBlockingRecoveryTag.

2022-08-25

Raporty

Dodaliśmy wymiar HOSTED_AD_CLIENT_ID, który umożliwia wydawcom hostującym i platformowym dzielenie danych według kont wydawców (wydawcy hostujący) i subkont (wydawcy platformowi).

2022-05-03

AdClient

Dodano metodę get.

Raporty

Dodano metodę getSaved.

UrlChannels

Dodano metodę get.

2022-03-31

Konto

Interfejs API zwraca teraz nieaktywne konta z polem state, które wskazuje stan konta.

AdClient

Podobnie jak w przypadku zmian na koncie, interfejs API zwraca teraz nieaktywnych klientów reklam, a state polewskazuje stan klienta reklam.

2022-02-24

Płatność

Format nazwy zasobu został rozszerzony, aby obsługiwać oddzielne zasoby w przypadku zarobków w YouTube. Ta zmiana zostanie wprowadzona przed stopniowym wdrażaniem ulepszonego AdSense dla twórców YouTube, w ramach którego zarobki z YouTube będą rozdzielane na osobne konto płatności. Informacje o płatnościach z YouTube będą też zwracane przez metodę listy płatności, gdy będziesz mieć osobne konto płatności do zarobków z YouTube. Przychody z YouTube będą miały format nazwy zasobu:
- accounts/{account}/payments/youtube-unpaid dla niewypłaconych (bieżących) zarobków z YouTube.
- accounts/{account}/payments/youtube-yyyy-MM-dd w przypadku zarobków z płatnego YouTube.
Uwaga: nazwy zasobów dotyczące zarobków w AdSense pozostają bez zmian:
- accounts/{account}/payments/unpaid w przypadku niewypłaconych (bieżących) zarobków z AdSense.
- accounts/{account}/payments/yyyy-MM-dd w przypadku zarobków z AdSense.

2021-06-30

Zgłoś

Dodaliśmy wymiary AD_FORMAT_NAME i AD_FORMAT_CODE, które wskazują sposób wyświetlania reklamy użytkownikom Twojej witryny (na stronie, w formie reklamy winietowej itp.). Wersja 1.4 zawierała (wycofane) wymiary o tych samych nazwach, ale innych elementach. Dwa wymiary dodane w wersji 2 różnią się od tych, które były obecne w wersji 1.4.

19 kwietnia 2021 r. (pierwsza wersja)

Ogólne

Usunęliśmy wszystkie wycofane metody w wersji 1.4. Obejmuje to metody zasobów, które nie wymagały accountId. W wersji 2 wartość accountId jest określana w polu parent.
Zgodnie ze standardami interfejsu API Google zasoby są teraz identyfikowane za pomocą pola name. Na przykład nazwa klienta reklamowego wyglądałaby 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 reporting_dimension_id polu w kilku zasobach.
Pole kind zostało usunięte ze wszystkich zasobów.

Konto

Wartość pola name została zmieniona 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, które zawiera listę zaległych zadań, które należy wykonać w ramach procesu rejestracji nowego konta. Mogą one dotyczyć np. profilu płatności lub weryfikacji telefonu.
Pole sub_accounts zostało usunięte. Podobną funkcję można uzyskać w wersji 2 za pomocą metody niestandardowej listChildAccounts. Pełne drzewo kont podrzędnych można wygenerować w wersji 2, wywołując rekursywnie funkcję listChildAccounts.

AdClient

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

AdUnit

Pole status nosi teraz nazwę state. Stan ACTIVE nie wskazuje już, czy w ciągu ostatnich 7 dni w tej jednostce reklamowej wystąpiła aktywność. W przypadku 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ść można nadal znaleźć 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.
Usunięte zostaną też inne pola, które zostały już usunięte w interfejsie 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ść można nadal znaleźć na końcu pola name (po ostatnim ukośniku).
Pole targeting_info zostało usunięte, ponieważ zostało już usunięte z interfejsu AdSense.

Płatność

Nazwę pola payment_date zmieniono na date i zmieniono typ z ciągu znaków na google.type.Date.
Pola payment_amount i payment_amount_currency_code zostały połączone w jedno pole payment (np. „1235 JPY”, „1234,57 PLN”, „87,65 PLN”).

Zgłoś

W wersji 2 dane raportowania interfejsu AdSense Management API są teraz zgodne z interfejsem AdSense. Oznacza to, że usługi AdMob i YouTube nie są już obsługiwane. Dodatkowo interfejs API będzie obsługiwać tylko dane raportu z okresu 3 lat.
Zasób Metadata.dimensions i zasób Metadata.metrics zostały usunięte.
Dodaliśmy nowe metody generowania wersji raportu w formacie CSV, które zastępują parametry zapytania w wersji 1.4. Uwaga: w przypadku kompresji nadal możesz używać nagłówka HTTP „Accept-Encoding: gzip”.
Niektóre pola zostały zmienione podczas generowania raportu ad hoc.
- 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.
- Możesz teraz określić kilka typowych zakresów za pomocą date_range (np. TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS i LAST_30_DAYS) lub 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 typu string na typ google.type.Date. Uwaga: w rezultacie słowa kluczowe z datami względnymi (np. „today-6d”) nie są już obsługiwane.
- Pole logiczne use_timezone_reporting zostało zastąpione polem reporting_time_zone, które może mieć jedną z 2 wartości: ACCOUNT_TIME_ZONE lub GOOGLE_TIME_ZONE (co oznacza PST/PDT). W wersji 2 domyślna wartość to ACCOUNT_TIME_ZONE, która różni się od wartości domyślnej w wersji 1.4.
- Pole start_index zostało usunięte.
- Nazwa pola max_results została zmieniona na limit.
Podczas generowania zapisanych raportów niektóre pola zostały zmienione.
- 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

SavedAdStyle zostało usunięte, ponieważ zostało już usunięte z interfejsu AdSense.

Witryna

Sites zostały dodane, aby pobierać dane o witrynach dodanych przez Ciebie do konta AdSense.
Pole state określa, czy witryna jest w jednym z tych stanów: REQUIRES_REVIEW, GETTING_READY, READY, NEEDS_ATTENTION.
Pole auto_ads_enabled to wartość logiczna, która określa, czy w danej witrynie włączono reklamy automatyczne.