Bu sayfa, Cloud Translation API ile çevrilmiştir.

Sürüm Notları

Bu sayfada, AdSense Management API için sürüm notları sunulmaktadır.

Sürüm 2

Bu sürümde, kullanımdan kaldırılan işlevleri kaldırmak ve AdSense Management API'yi mevcut Google API standartlarıyla uyumlu hale getirmek amacıyla aşağıdaki değişiklikler yapılmıştır. Google API sürüm oluşturma şeması uyarınca bu sürüm, yeni işlevlerin ayrı alt sürümlerde kullanıma sunulması yerine zaman içinde ek (geriye dönük uyumlu) işlevler içerecek şekilde güncellenecektir.

2024-04-03

PolicyIssues

Bir hesaptaki mevcut politika ihlallerini ve uyarıları bildirmek için yeni bir koleksiyon eklendi.

2023-06-19

Ödemeler

payments.list artık premium yayıncılar için ödemelerle ilgili ayrıntıları döndürüyor.

2023-06-13

Raporlar

Reklam olmayan birimlerin (örneğin, ilgili arama birimleri) performansı hakkında bilgi sağlayan FUNNEL_REQUESTS, FUNNEL_IMPRESSIONS, FUNNEL_CLICKS ve FUNNEL_RPM metrikleri eklendi.

2023-03-30

Raporlar

Metriklerin sayfa URL'sine göre dökümünün yapılmasına olanak tanıyan PAGE_URL boyutu eklendi (bazı uyarılarla birlikte Sayfa URL'si dökümüne bakın).

2022-09-21

AdUnits

Oluşturma ve yama uygulama yöntemleri eklendi. Bu yöntemlerin yalnızca Platformlar için AdSense ürünü için etkinleştirilen projeler tarafından kullanılabileceğini unutmayın.

CustomChannels

Oluşturma, yama ve güncelleme yöntemleri eklendi. Bu yöntemlerin yalnızca Platformlar için AdSense ürünü için etkinleştirilen projeler tarafından kullanılabileceğini unutmayın.
Etkin alan kaynağa eklendi.

Hesaplar

getAdBlockRecoveryTag yöntemi eklendi.

2022-08-25

Raporlar

Ana makine ve platform yayıncılarının, metrikleri kendi yayıncılarına (barındırıcı yayıncılar) ve alt hesaplara (platform yayıncıları) göre ayırmasını sağlayan HOSTED_AD_CLIENT_ID boyutu eklendi.

2022-05-03

AdClient

get yöntemi eklendi.

Raporlar

getSaved yöntemi eklendi.

UrlChannels

get yöntemi eklendi.

2022-03-31

Hesap

Etkin olmayan hesaplar artık hesabın durumunu belirten bir state alanı ile API tarafından döndürülüyor.

AdClient

Yukarıdaki Hesap değişikliklerine benzer şekilde, etkin olmayan reklam istemcileri artık reklam istemcisinin durumunu belirten bir state alanı ile API tarafından döndürülüyor.

2022-02-24

Ödeme

Kaynak adı biçimi, YouTube kazançları için ayrı kaynakları destekleyecek şekilde genişletilmiştir. Bu değişiklik, YouTube içerik üreticileri için iyileştirilmiş AdSense deneyiminin aşamalı olarak kullanıma sunulmasından önce gerçekleştirilmiştir. Bu deneyimde YouTube kazançları, kendi ödeme hesaplarına ayrılacaktır. YouTube kazançları için özel bir ödeme hesabınız olduğunda, YouTube ödeme bilgileri ödeme listesi yönteminden de iade edilir. YouTube kazançları aşağıdaki kaynak adı biçiminde olur:
- accounts/{account}/payments/youtube-unpaid (Ödenmemiş (mevcut)) YouTube kazançları için ödeme yapabilirsiniz.
- accounts/{account}/payments/youtube-yyyy-MM-dd (ücretli YouTube kazançları için) başlıklı makaleyi inceleyin.
Not: AdSense kazançlarıyla ilgili kaynak adlarında değişiklik yapılmadı:
- /{account}/payments/ödemeleri yapılmamış (mevcut) AdSense kazançları için ödenmemiş tutar.
- accounts/{account}/payments/yyyy-MM-dd (Ödemeli AdSense kazançları için) kullanın.

2021-06-30

Bildir

Bir reklamın sitenizdeki kullanıcılara nasıl gösterileceğini belirten AD_FORMAT_NAME ve AD_FORMAT_CODE boyutları eklendi (sayfa içi, vinyet vb.). v1.4'te, aynı ada ancak farklı üyelere sahip (kullanımdan kaldırılmış) boyutlar bulunduğunu, ancak v2'de eklenen iki boyutun v1.4'te bulunan boyutlardan farklı olduğunu unutmayın.

19.04.2021 (İlk sürüm)

Genel

v1.4'te desteği sonlandırılan tüm yöntemler kaldırıldı. Bu, accountId gerektirmeyen kaynak yöntemlerini içerir. v2'de, accountId parent alanında belirtilir.
Google API standartlarına göre kaynaklar artık name alanıyla tanımlanmaktadır. Örneğin, bir AdClient şu şekildedir: accounts/{accountId}/adclients/{adClientId}. Buna ek olarak, v1.4'te kaynak kimliği bir raporlama boyutu olarak kullanıldı ancak v2'de bu değer birkaç kaynaktaki reporting_dimension_id alanı üzerinden kullanılabilir.
kind alanı tüm kaynaklardan kaldırıldı.

Hesap

name alanı, display_name olarak değiştirildi.
Dize olan timezone alanı, google.type.TimeZone olarak değiştirildi.
creation_time alanı (int64 türü), create_time (tür: google.protobuf.Timestamp) olarak değiştirildi.
Yeni bir hesap için kayıt işlemi kapsamında tamamlanması gereken bekleyen görevlerin listesini içeren bir pending_tasks alanı eklendi. Örneğin, görevler faturalandırma profilinizle veya telefonla doğrulamayla ilgili olabilir.
sub_accounts alanı kaldırıldı. Benzer işlevler, listChildAccounts özel yöntemiyle v2'de elde edilebilir. v2'de listChildAccounts alt hesap ağacını tekrarlı olarak çağırarak tam alt hesap ağacı oluşturulabilir.

AdClient

arc_opt_in alanı, AdSense kullanıcı arayüzünden zaten kaldırılmış olduğu için kaldırıldı.
supports_reporting alanı, AD_CLIENT_ID raporlama boyutunda kullanılan reklam istemcisinin benzersiz kimliğini temsil eden reporting_dimension_id alanı ile değiştirilmiştir. reporting_dimension_id boşsa AdClient, raporlamayı desteklemiyordur.

AdUnit

status alanı, state olarak yeniden adlandırıldı. Ayrıca, ACTIVE durumu artık son yedi gün içinde bu reklam biriminde etkinlik olup olmadığını belirtmez. v2'de bu, reklam biriminin kullanıcı tarafından etkinleştirildiği ve reklam yayınlayabileceği anlamına gelir.
code alanı kaldırıldı. Bu değer hâlâ name alanının sonunda (son öne eğik çizgiden sonra) bulunabilir.
contentAdsSettings.backupOption alanı kaldırıldı.
type alanı TYPE_UNSPECIFIED, DISPLAY, FEED, ARTICLE, MATCHED_CONTENT ve LINK değerleriyle sınırlandırıldı.
AdSense kullanıcı arayüzünde kaldırılmış olan diğer alanlar da kaldırılmıştır: custom_style, saved_style_id, mobile_content_ads_settings, feed_ads_settings.

Uyarı

delete yöntemi kaldırıldı.
is_dismissible alanı kaldırıldı.
locale alanı, language_code olarak yeniden adlandırıldı.

CustomChannel

code alanı kaldırıldı. Bu değer hâlâ name alanının sonunda (son öne eğik çizgiden sonra) bulunabilir.
targeting_info alanı, AdSense kullanıcı arayüzünden zaten kaldırılmış olduğu için kaldırılmıştır.

Ödeme

payment_date alanı date olarak yeniden adlandırıldı ve tür dizesi yerine google.type.Date olarak değiştirildi.
payment_amount ve payment_amount_currency_code alanı, tek bir payment alanı (ör. "1.235 JPY", "1.234,57 ABD doları", "87,65 sterlin").

Bildir

Sürüm 2 ile birlikte, AdSense Management API raporlama verileri artık AdSense kullanıcı arayüzü ile uyumlu hale gelmiştir. Bu, AdMob ve YouTube mülklerinin artık desteklenmediği anlamına gelir. Ayrıca API yalnızca 3 yıl öncesine ait rapor verilerini destekler.
Metadata.dimensions ve Metadata.metrics kaynağı kaldırıldı.
Raporun CSV sürümünü oluşturmak için v1.4'teki sorgu parametrelerinin yerini alan yeni yöntemler eklendi. Not: Sıkıştırma için yine de " Accept-Encoding: gzip" HTTP üst bilgisini kullanabilirsiniz.
Anlık rapor oluşturma sırasında bazı alanlar değiştirildi.
- account_id alanı, account olarak yeniden adlandırıldı.
- dimension alanı, dimensions olarak yeniden adlandırıldı.
- metric alanı, metrics olarak yeniden adlandırıldı.
- filter alanı, filters olarak yeniden adlandırıldı.
- sort alanı, order_by olarak yeniden adlandırıldı.
- locale alanı, language_code olarak yeniden adlandırıldı.
- currency alanı, currency_code olarak yeniden adlandırıldı.
- Artık date_range ile birkaç ortak aralık belirtebilirsiniz (ör. TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS, LAST_30_DAYS) ya da date_range değerini CUSTOM olarak ayarlayarak bir start_date ve end_date belirtebilirsiniz.
- start_date ve end_date alanları tür dizesinden google.type.Date türüne değiştirildi. Not: Bu nedenle, göreli tarih anahtar kelimeleri (ör. "bugün-6 gün") artık desteklenmemektedir.
- use_timezone_reporting boole alanı, şu iki değerden birine sahip olabilen reporting_time_zone ile değiştirildi: ACCOUNT_TIME_ZONE veya GOOGLE_TIME_ZONE (PST/PDT anlamına gelir). ACCOUNT_TIME_ZONE, v2'de varsayılan ayar olup v1.4'teki varsayılan değerden farklıdır.
- start_index alanı kaldırıldı.
- max_results alanı, limit olarak yeniden adlandırıldı.
Kayıtlı rapor oluşturma sırasında bazı alanlar değiştirildi.
- Tarih alanları eklendi (date_range, start_date, end_date, reporting_time_zone).
- currency_code alanı eklendi.
- locale alanı, language_code olarak yeniden adlandırıldı.
- start_index alanı kaldırıldı.
- max_results alanı kaldırıldı.

SavedAdStyle

SavedAdStyle, AdSense kullanıcı arayüzünden kaldırılmış olduğu için kaldırıldı.

Site

AdSense hesabınıza eklediğiniz web siteleriyle ilgili verileri getirmek için Sites eklendi.
state alanı, sitenin şu durumlardan herhangi biri olup olmadığını gösterir: REQUIRES_REVIEW, GETTING_READY, READY, NEEDS_ATTENTION.
auto_ads_enabled alanı, otomatik reklamların belirli bir sitede etkinleştirilip etkinleştirilmediğini temsil eden bir boole değeridir.