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 şeması uyarınca bu sürüm, yeni işlevlerin ayrı alt sürümlerde kullanıma sunulması yerine ek (geriye dönük uyumlu) işlevler içerecek şekilde zaman içinde güncellenecektir.

2023-06-19

Ödemeler

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

2023-06-13

Raporlar

Reklam dışı 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 alınabilmesini sağlayan 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 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ırmalarına olanak tanıyan HOSTED_AD_CLIENT_ID boyutu eklendi.

2022-05-03

AdClient

"get" yöntemi eklendi.

Raporlar

getSave 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ı için ilgili ödeme verileri ayrı olarak paylaşılacaktır. YouTube ödeme bilgileri, YouTube kazançları için özel bir ödeme hesabınız olduğunda ödeme listesi yönteminden de iade edilir. YouTube kazançları aşağıdaki kaynak adı biçiminde olur:
- Ödenmemiş (mevcut) YouTube kazançları için accounts/{account}/payments/youtube-unpaid'i kullanın.
- accounts/{account}/payments/youtube-yyyy-MM-dd (Ücretli YouTube kazançları için) ekleyin.
Not: AdSense kazançlarının kaynak adları değiştirilmemiştir:
- accounts/{account}/payments/ödenmeyen (mevcut) AdSense kazançları için ödenmemiş tutar.
- accounts/{account}/payments/yyyy-MM-dd (hesap ödemeli AdSense kazançları için)

2021-06-30

Bildir

Bir reklamın sitenizdeki kullanıcılara nasıl gösterildiğ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 unutmayın. v2'de eklenen iki boyut, v1.4'te bulunan boyutlardan farklıdır.

19.04.2021 (İlk sürüm)

Genel

v1.4'te desteği sonlandırılmış tüm yöntemler kaldırılmıştır. Bu, accountId gerektirmeyen kaynak yöntemlerini içerir. v2'de, accountId, parent alanında belirtilir.
Google API standartları uyarınca kaynaklar artık name alanıyla tanımlanıyor. Örneğin, bir AdClient'ın adı accounts/{accountId}/adclients/{adClientId} gibi görünür. Buna ek olarak, v1.4'te kaynak kimliği bir raporlama boyutu olarak kullanıldı ancak v2'de bu değer artık çeşitli kaynaklardaki bir reporting_dimension_id alanı üzerinden kullanılabilir.
kind alanı tüm kaynaklardan kaldırıldı.

Hesap

name alanı display_name olarak değiştirildi.
timezone alanı, bir dizeden 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 hesaba kaydolma işleminin bir parçası olarak 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ı. v2'de listChildAccounts özel yöntemi kullanılarak benzer işlevler elde edilebilir. v2'de tam alt hesap ağacı, tekrarlı olarak listChildAccounts çağrısı yapılarak oluşturulabilir.

AdClient

arc_opt_in alanı, AdSense kullanıcı arayüzünden zaten kaldırıldığı için kaldırıldı.
supports_reporting alanı, reklam istemcisinin AD_CLIENT_ID raporlama boyutunda kullanılan benzersiz kimliğini temsil eden reporting_dimension_id alanı ile değiştirilir. 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, reklam biriminin kullanıcı tarafından etkinleştirildiği ve reklam sunabileceği anlamına gelir.
code alanı kaldırıldı. Bu değer yine 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 kısıtlanmıştır.
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 yine name alanının sonunda (son öne eğik çizgiden sonra) bulunabilir.
targeting_info alanı, AdSense kullanıcı arayüzünden zaten kaldırıldığı için kaldırıldı.

Ödeme

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

Bildir

Sürüm 2 ile birlikte, AdSense Management API raporlama verileri artık AdSense kullanıcı arayüzü ile uyumludur. Bu, AdMob ve YouTube mülklerinin artık desteklenmediği anlamına geliyor. Ayrıca API yalnızca 3 yıl öncesine ait rapor verilerini destekler.
Metadata.dimensions kaynağı ve Metadata.metrics kaynağı kaldırıldı.
Raporun CSV sürümünü oluşturmak için 1.4 sürümündeki sorgu parametrelerini değiştirerek 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: Sonuç olarak, göreli tarih anahtar kelimeleri (ör. "today-6d") artık desteklenmemektedir.
- use_timezone_reporting boole alanı, şu iki değerden birine sahip olabilecek reporting_time_zone ile değiştirildi: ACCOUNT_TIME_ZONE veya GOOGLE_TIME_ZONE (PST/PDT anlamına gelir). ACCOUNT_TIME_ZONE, v2'deki varsayılan değerdir ve v1.4'teki varsayılan ayardan 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.
- Eklenen tarih alanları (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ğundan kaldırıldı.

Site

AdSense hesabınıza eklediğiniz web siteleriyle ilgili verileri getirmek için Sites eklendi.
state alanı, sitenin şu durumlardan birinde 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.