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

Informacje o wersjach

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

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 interfejsu API Google. Zgodnie z schematem obsługi wersji interfejsów API Google ta wersja będzie z czasem aktualizowana tak, aby obejmowała dodatkowe funkcje (zgodne wstecznie), a nie nowe funkcje udostępniane w osobnych wersjach podrzędnych.

2024-04-03

PolicyIssues

Dodaliśmy nową kolekcję do zgłaszania bieżących naruszeń zasad i ostrzeżeń na koncie.

2023-06-19

Płatności

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 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: zestawienie adresów URL stron).

2022-09-21

AdUnits

Dodano metody tworzenia i stosowania poprawek. Pamiętaj, że tych metod można używać tylko w projektach z włączoną usługą AdSense dla platform.

CustomChannels

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

Konta

Dodano metodę getAdTrackingRecoveryTag.

2022-08-25

Raporty

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

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, a pole state wskazuje stan konta.

AdClient

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

2022-02-24

Płatność

Rozszerzyliśmy format nazwy zasobu, aby obsługiwać osobne zasoby zarobków z YouTube. Ta zmiana nastąpi przed stopniowym wprowadzeniem ulepszonej wersji AdSense dla twórców YouTube, w której zarobki z YouTube będą dodawane do osobnego konta płatności. Gdy będziesz już mieć specjalne konto płatności z YouTube, dane karty z YouTube będą też zwracane za pomocą formy listy płatności. Zarobki w YouTube będą miały następujący format nazwy zasobu:
- accounts/{account}/payments/youtube-unpaid (bieżące) zarobki z YouTube.
- accounts/{account}/payments/youtube-yyyy-MM-dd dla zarobków z YouTube.
Uwaga: nazwy zasobów zarobków z AdSense pozostają bez zmian:
- accounts/{konto}/payments/niezapłacone za niewypłacone (bieżące) zarobki z AdSense.
- accounts/{konto}/payments/rrrr-MM-dd za 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 na Twojej stronie (na stronie, reklama winietowa itp.). Pamiętaj, że wersja 1.4 miała (wycofane) wymiary z takimi samymi nazwami, ale różnymi elementami. Dwa wymiary dodane w wersji 2 różnią się od tych, które występują w wersji 1.4.

19.04.2021 r. (wstępna 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 wartość accountId jest określona w polu parent.
Zgodnie ze standardami interfejsów API Google zasoby są teraz identyfikowane przez pole name. Na przykład nazwa AdClient będzie wyglądać tak: accounts/{accountId}/adclients/{adClientId}. Dodatkowo w wersji 1.4 jako wymiar raportowania był używany identyfikator zasobu, 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, które zawiera listę zaległych zadań do wykonania w ramach procesu rejestracji nowego konta. Zadania mogą być na przykład 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ć dzięki metodzie niestandardowej listChildAccounts. Pełne drzewo kont podrzędnych można wygenerować w wersji 2, wywołując rekurencyjnie polecenie listChildAccounts.

AdClient

Pole arc_opt_in zostało usunięte, 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 reklamowego 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 miała miejsce aktywność w tej jednostce 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. Nadal będzie można ją 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.
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. Nadal będzie można ją znaleźć 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 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”).

Zgłoś

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. Dodatkowo interfejs API obsługuje tylko dane z raportów sprzed 3 lat.
Zasób Metadata.dimensions i zasób Metadata.metrics zostały usunięte.
Dodano nowe metody generowania raportu w wersji CSV, które zastępują parametry zapytania w wersji 1.4. Uwaga: w celu kompresji możesz nadal używać nagłówka HTTP „Accept-Encoding: gzip”.
Niektóre pola zostały zmienione podczas generowania raportu doraźnego.
- 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ą właściwości date_range możesz teraz określić kilka wspólnych 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 typu na google.type.Date. Uwaga: w związku z tym uwzględnianie słów kluczowych powiązanych z datą (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 (czyli PST/PDT). Wartością domyślną w wersji 2 jest ACCOUNT_TIME_ZONE. Różni się ona 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.
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

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

Witryna,

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