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
veFUNNEL_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
veAD_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 birreporting_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 dizedengoogle.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'delistChildAccounts
özel yöntemi kullanılarak benzer işlevler elde edilebilir. v2'de tam alt hesap ağacı, tekrarlı olaraklistChildAccounts
ç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 istemcisininAD_CLIENT_ID
raporlama boyutunda kullanılan benzersiz kimliğini temsil edenreporting_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 yinename
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
veLINK
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 yinename
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 dizesindengoogle.type.Date
türü olarak değiştirildi.payment_amount
alanı vepayment_amount_currency_code
alanı, tek birpayment
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ğı veMetadata.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 dadate_range
değeriniCUSTOM
olarak ayarlayarak birstart_date
veend_date
belirtebilirsiniz. start_date
veend_date
alanları, tür dizesindengoogle.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 olabilecekreporting_time_zone
ile değiştirildi:ACCOUNT_TIME_ZONE
veyaGOOGLE_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ı.
- Eklenen tarih alanları (
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.
Sürüm 1.4
Bu sürümde aşağıdaki işlevler sunulmaktadır:
- Artık AdSense hesabı ödemelerinizi ilgili para biriminde listeleyebilirsiniz.
- Artık
delete
yöntemini çağırarak uyarıları API'de ve AdSense web arayüzünde gizleyebilirsiniz. - Rapor yanıtı artık başlangıç ve bitiş tarihlerini içeriyor. Rapor oluştururken göreli tarihler (ör.
today
,yesterday
,firstDayOfMonth-1m
) kullanıyorsanız yanıt artık istediğiniz tarih aralığını içeriyor.
Bilinen Sorunlar
Raporlardaki currency
alanı bu sürümde desteklenmiyor.
Sürüm 1.3
Bu sürümde aşağıdaki işlevler sunulmaktadır:
- Uyarıları alma olanağı.
- Metrikler ve boyutlar meta verilerini alma olanağı.
- Hesabın yerel saat diliminde rapor çalıştırabilme
Bilinen Sorunlar
Raporlardaki currency
alanı bu sürümde desteklenmiyor.
Sürüm 1.2
Bu sürümde aşağıdaki işlevler sunulmaktadır:
- Reklam stillerini alma olanağı.
- Ön uçta tanımlanan kayıtlı raporları alma ve yürütme olanağı.
Bilinen Sorunlar
Raporlardaki currency
alanı bu sürümde desteklenmiyor.
Sürüm 1.1
Bu sürümde aşağıdaki işlevler sunulmaktadır:
- Kullanıcının erişimi olan hesapları listeleme olanağı
- Belirli bir hesapta GET çağrısı yapabilme olanağı
- Reklam birimlerinde ve özel kanallarda GET çağrıları yapabilme olanağı
- Reklam birimleri ile özel kanallar arasındaki bağlantıları belirleyebilme
- Özel kanallar, hedefleme bilgileriyle ilgili daha fazla veri içerir
Ayrıca, verilere artık varsayılan hesabınız veya belirli bir hesap altında da erişebilirsiniz.
Bilinen Sorunlar
Raporlardaki currency
alanı bu sürümde desteklenmiyor.
Sürüm 1
Bu, API'nin ilk sürümüdür. Reklam istemcilerini, reklam birimlerini, özel kanalları, URL kanallarını alma ve rapor çalıştırma desteği içerir.
Bilinen Sorunlar
Raporlardaki currency
alanı bu sürümde desteklenmiyor.