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

Ta wersja wprowadza następujące zmiany, aby usunąć wycofane funkcje i dostosować interfejs AdSense Management API do obecnych standardów interfejsów API Google. Zgodnie z schematem wersji interfejsu Google API ta wersja będzie z czasem aktualizowana, aby uwzględniać dodatkowe funkcje (zgodne ze starszymi wersjami), zamiast wydawać nowe funkcje w osobnych wersjach podrzędnych.

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 lub ustawienia reklamodawcy. Zastępuje ono pole policyTopics[].must_fix, które jest teraz oznaczone jako wycofane.

2024-04-03

PolicyIssues

Dodaliśmy nową kolekcję, aby zgłaszać aktualne naruszenia zasad i ostrzeżenia dotyczące konta.

2023-06-19

Płatności

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

2023-06-13

Raporty

Dodano dane FUNNEL_REQUESTS, FUNNEL_IMPRESSIONS, FUNNEL_CLICKS i FUNNEL_RPM, które zawierają informacje o skuteczności jednostek niebędących reklamami (np. powiązanych jednostek reklamowych w wyszukiwarce).

2023-03-30

Raporty

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

2022-09-21

AdUnits

Dodano metody tworzenia i łatania. Pamiętaj, że tych metod mogą używać tylko projekty włączone w usłudze AdSense dla platform.

CustomChannels

Dodano metody tworzenia, łatania i aktualizowania. Pamiętaj, że tych metod mogą używać tylko projekty włączone w usłudze AdSense dla platform.
Dodano do zasobu pole aktywny.

Konta

Dodano metodę getAdBlockingRecoveryTag.

2022-08-25

Raporty

Dodaliśmy wymiar HOSTED_AD_CLIENT_ID, który umożliwia wydawcom hosta i platformy podział danych na konta wydawcy (wydawcy hosta) i podkonta (wydawcy platformy).

2022-05-03

AdClient

Dodano metodę get.

Raporty

Dodano metodę getSaved.

UrlChannels

Dodano metodę get.

2022-03-31

Konto

Interfejs API zwraca teraz informacje o nieaktywnych kontach w polu state, co wskazuje na stan konta.

AdClient

Podobnie jak w przypadku zmian dotyczących kont, interfejs API zwraca teraz nieaktywne konta reklamowe, a pole state wskazuje na ich stan.

2022-02-24

Płatność

Format nazwy zasobu został rozszerzony, aby obsługiwać osobne zasoby dotyczące zarobków w YouTube. Ta zmiana poprzedza stopniowe wdrażanie ulepszonej wersji AdSense dla twórców YouTube, w ramach której przychody z YouTube zostaną rozdzielone na osobne konto płatności. Informacje o płatnościach w YouTube będą również zwracane z listy metod płatności, gdy będziesz mieć osobne konto płatności do zarobków z YouTube. Zarobki w YouTube będą miały następujący format nazwy zasobu:
- accounts/{account}/payments/youtube-unpaid – niewypłacone (obecne) zarobki z YouTube.
- accounts/{account}/payments/youtube-yyyy-MM-dd w przypadku zarobków z YouTube.
Uwaga: nazwy zasobów dotyczących zarobków w AdSense pozostają bez zmian:
- accounts/{account}/payments/unpaid – niewypłacone (obecne) zarobki z AdSense.
- accounts/{account}/payments/yyyy-MM-dd, aby sprawdzić wypłacone zarobki z AdSense.

2021-06-30

Zgłoś

Dodano wymiary AD_FORMAT_NAME i AD_FORMAT_CODE, które wskazują sposób wyświetlania reklamy użytkownikom w Twojej witrynie (na stronie, w winiecie itp.). Pamiętaj, że wersja 1.4 zawierała (wycofane) wymiary o tych samych nazwach, ale z różnymi wartościami. 2 wymiary dodane w wersji 2 różnią się od tych, które były dostępne w wersji 1.4.

19.04.2021 (pierwsza wersja)

Ogólne

Wszystkie wycofane metody w wersji 1.4 zostały usunięte. Obejmuje to zasoby methods, które nie wymagają accountId. W wersji 2 parametr accountId jest określony w polu parent.
Zgodnie ze standardami interfejsów API Google zasoby są teraz identyfikowane za pomocą pola name. Na przykład nazwa AdClient 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 polu reporting_dimension_id w kilku zasobach.
Pole kind zostało usunięte ze wszystkich zasobów.

Konto

Wartość pola name została zmieniona na display_name.
Zmiana typu pola timezone z łańcucha znaków na google.type.TimeZone.
Pole creation_time (typ int64) zostało zmienione na create_time (typ google.protobuf.Timestamp).
Dodano pole pending_tasks, czyli listę zadań, które należy wykonać w ramach procesu rejestracji nowego konta. Mogą one na przykład dotyczyć Twojego 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. W wersji 2 pełne drzewo kont podrzędnych można wygenerować, wywołując funkcję listChildAccounts w poziomie rekurencyjnym.

AdClient

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

AdUnit

Nazwa pola status została zmieniona na state. Stan ACTIVE nie wskazuje już, czy w ciągu ostatnich 7 dni wystąpiła aktywność 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. Wartość tę można 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.
Usunęliśmy 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. Wartość tę można 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ść

Nazwa pola payment_date została zmieniona na date, a jego typ z ciągu znaków 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 USD”, "87,65 GBP”).

Zgłoś

W wersji 2 dane z raportów interfejsu AdSense Management API są zgodne z interfejsem AdSense. Oznacza to, że usługi AdMob i YouTube nie są już obsługiwane. Interfejs API obsługuje tylko dane raportowania z ostatnich 3 lat.
Zasoby Metadata.dimensions i Metadata.metrics zostały usunięte.
Dodano nowe metody generowania wersji raportu w formacie CSV, które zastępują parametry zapytania w wersji 1.4. Uwaga: w celu kompresji nadal możesz używać nagłówka HTTP „Accept-Encoding: gzip”.
Niektóre pola zostały zmienione w przypadku generowania raportów 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ą pola date_range (np. TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS i LAST_30_DAYS) lub określić start_date i end_date, ustawiając date_range na CUSTOM.
- Pola start_date i end_date zostały zmienione z typu ciąg znaków na typ google.type.Date. Uwaga: w efekcie słowa kluczowe z względną datą (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 czas PST/PDT). Wartość domyślna w wersji 2 to ACCOUNT_TIME_ZONE, co 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.
W generowaniu zapisanych raportów zmieniono niektóre pola.
- 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ł usunięty, ponieważ został już usunięty z interfejsu AdSense.

Witryna

Sites zostały dodane, aby pobierać dane o witrynach dodanych do konta AdSense.
Pole state wskazuje, czy witryna znajduje się w jednym z tych stanów: REQUIRES_REVIEW, GETTING_READY, READY lub NEEDS_ATTENTION.
Pole auto_ads_enabled to pole wartości logicznej, które określa, czy reklamy automatyczne zostały włączone w danej witrynie.