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

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_CLICKSFUNNEL_RPM, które zawierają informacje o skuteczności jednostek niebędących reklamami (np. powiązanych jednostek reklamowych w wyszukiwarce).

2023-03-30

Raporty

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

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_NAMEAD_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_dateend_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.

Wersja 1.4

Ta wersja wprowadza te funkcje:

  • Teraz możesz wyświetlać płatności na koncie AdSense w odpowiedniej walucie.
  • Możesz teraz zamknąć alert, wywołując metodę delete, która spowoduje ukrycie alertu w interfejsie API i internetowym AdSense.
  • Odpowiedź na raport zawiera teraz daty rozpoczęcia i zakończenia. To ważne: jeśli podczas generowania raportów używasz dat względnych (np. today, yesterday, firstDayOfMonth-1m), odpowiedź będzie zawierać zakres dat, o który prosisz.

Znane problemy

W tej wersji pole currency w raportach nie jest obsługiwane.

Wersja 1.3

Ta wersja wprowadza te funkcje:

  • możliwość pobierania alertów.
  • możliwość pobierania metadanych danych i wymiarów.
  • Możliwość uruchamiania raportów w strefie czasowej lokalnej konta.

Znane problemy

W tej wersji pole currency w raportach nie jest obsługiwane.

Wersja 1.2

Ta wersja wprowadza te funkcje:

  • możliwość pobierania stylów reklam;
  • możliwość pobierania i wykonywania zapisanych raportów zdefiniowanych w interfejsie;

Znane problemy

W tej wersji pole currency w raportach nie jest obsługiwane.

Wersja 1.1

Ta wersja wprowadza te funkcje:

Dodatkowo możesz teraz uzyskać dostęp do danych na koncie domyślnym lub na konkretnym koncie.

Znane problemy

W tej wersji pole currency w raportach nie jest obsługiwane.

Wersja 1

To pierwsza wersja interfejsu API. Obejmuje ona obsługę pobierania klientów reklamowych, jednostek reklamowych, kanałów niestandardowych i kanałów URL oraz generowania raportów.

Znane problemy

W tej wersji pole currency w raportach nie jest obsługiwane.