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 polepolicyTopics[].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
iFUNNEL_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
iAD_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 parametraccountId
jest określony w poluparent
. - 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 polureporting_dimension_id
w kilku zasobach. - Pole
kind
zostało usunięte ze wszystkich zasobów.
Konto
- Wartość pola
name
została zmieniona nadisplay_name
. - Zmiana typu pola
timezone
z łańcucha znaków nagoogle.type.TimeZone
. - Pole
creation_time
(typ int64) zostało zmienione nacreate_time
(typgoogle.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 niestandardowejlistChildAccounts
. 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 polemreporting_dimension_id
, które zawiera unikalny identyfikator klienta reklamy używany w wymiarze raportowaniaAD_CLIENT_ID
. Jeślireporting_dimension_id
jest pusty, oznacza to, że AdClient nie obsługuje raportowania.
AdUnit
- Nazwa pola
status
została zmieniona nastate
. StanACTIVE
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 polaname
(po ostatnim ukośniku). - Pole
contentAdsSettings.backupOption
zostało usunięte. - Pole
type
zostało ograniczone do wartościTYPE_UNSPECIFIED
,DISPLAY
,FEED
,ARTICLE
,MATCHED_CONTENT
iLINK
. - 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 nalanguage_code
.
CustomChannel
- Pole
code
zostało usunięte. Wartość tę można znaleźć na końcu polaname
(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 nadate
, a jego typ z ciągu znaków nagoogle.type.Date
. - Pole
payment_amount
i polepayment_amount_currency_code
zostały połączone w jedno polepayment
(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
iMetadata.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 naaccount
. - Nazwa pola
dimension
została zmieniona nadimensions
. - Nazwa pola
metric
została zmieniona nametrics
. - Nazwa pola
filter
została zmieniona nafilters
. - Nazwa pola
sort
została zmieniona naorder_by
. - Nazwa pola
locale
została zmieniona nalanguage_code
. - Nazwa pola
currency
została zmieniona nacurrency_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
iLAST_30_DAYS
) lub określićstart_date
iend_date
, ustawiającdate_range
naCUSTOM
. - Pola
start_date
iend_date
zostały zmienione z typu ciąg znaków na typgoogle.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 polemreporting_time_zone
, które może mieć jedną z 2 wartości:ACCOUNT_TIME_ZONE
lubGOOGLE_TIME_ZONE
(co oznacza czas PST/PDT). Wartość domyślna w wersji 2 toACCOUNT_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 nalimit
.
- Nazwa pola
-
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 nalanguage_code
. - Pole
start_index
zostało usunięte. - Pole
max_results
zostało usunięte.
- Dodano pola daty (
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
lubNEEDS_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:
- Możliwość wyświetlenia listy kont, do których użytkownik ma dostęp.
- Możliwość wywołania GET na konkretnym koncie
- Możliwość wykonywania wywołań GET w przypadku jednostek reklamowych i kanałów niestandardowych.
- Możliwość określania połączeń między jednostkami reklamowymi a kanałami niestandardowymi
- Kanały niestandardowe zawierają więcej danych o informacjach kierowania
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.