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

Sürüm Notları

Bu sayfada, AdSense Management API'nin sürüm notları bulunmaktadı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ına uygun hale getirmek için aşağıdaki değişiklikler yapılmıştır. Google API sürümlendirme şemasına göre bu sürüm, yeni işlevlerin ayrı ara sürümlerde yayınlanması yerine zaman içinde ek (geriye dönük uyumlu) işlevler içerecek şekilde güncellenecektir.

2025-02-24

PolicyIssues

Bir politika konusunun politika sorunu, yasal düzenlemeyle ilgili sorun veya reklamveren tercihi olup olmadığını belirlemek için policyTopics[].type alanı eklendi. Bu alan, artık kullanımdan kaldırılmış alan olarak işaretlenen policyTopics[].must_fix alanının yerini almıştır.

2024-04-03

PolicyIssues

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

2023-06-19

Ödemeler

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

2023-06-13

Raporlar

Reklam dışı birimlerin (ör. 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 ayrıntılandırılmasına olanak tanıyan PAGE_URL boyutu eklendi (bazı istisnalar vardır, Sayfa URL'si dökümü bölü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ğına eklendi.

Hesaplar

getAdBlockingRecoveryTag yöntemi eklendi.

2022-08-25

Raporlar

Ana makine ve platform yayıncılarının metrikleri yayıncı hesaplarına (ana makine yayıncıları) ve alt hesaplara (platform yayıncıları) göre dökümüne olanak tanıyan 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 API tarafından hesabın durumunu belirten bir state alanıyla döndürülüyor.

AdClient

Yukarıdaki hesap değişikliklerine benzer şekilde, API artık etkin olmayan reklam istemcilerini reklam istemcisinin durumunu belirten bir state alanıyla döndürüyor.

2022-02-24

Ödeme

Kaynak adı biçimi, YouTube kazançları için ayrı kaynakları destekleyecek şekilde genişletildi. Bu değişiklik, YouTube kazançlarının kendi ödeme hesabına ayrılacağı YouTube içerik üreticileri için geliştirilmiş AdSense deneyiminin aşamalı olarak kullanıma sunulmasından önce gerçekleşiyor. YouTube kazançlarınız için özel bir ödeme hesabınız olduğunda YouTube ödeme bilgileri de ödeme listesi yönteminden döndürülür. YouTube kazançları için şu kaynak adı biçimi kullanılır:
- Hesaplar/{hesap}/ödemeler/youtube-unpaid (ödenmemiş (mevcut) YouTube kazançları için)
- Ücretli YouTube kazançları için accounts/{account}/payments/youtube-yyyy-MM-dd.
Not: AdSense kazançları için kaynak adları değişmez:
- Ödenmemiş (mevcut) AdSense kazançları için accounts/{account}/payments/unpaid.
- Ücretli AdSense kazançları için accounts/{account}/payments/yyyy-MM-dd.

2021-06-30

Bildir

Bir reklamın sitenizdeki kullanıcılara gösterilme şeklini (sayfa içi, vinyet vb.) belirten AD_FORMAT_NAME ve AD_FORMAT_CODE boyutları eklendi. 1.4 sürümünde aynı ada sahip ancak farklı üyelere sahip boyutların (desteği sonlandırılmış) bulunduğunu unutmayın. 2. sürüme eklenen iki boyut, 1.4 sürümündeki boyutlardan farklıdır.

2021-04-19 (İlk sürüm)

Genel (General)

1.4 sürümünde kullanımdan kaldırılan tüm yöntemler kaldırıldı. accountId gerektirmeyen kaynak yöntemleri de buna dahildir. accountId, v2'de parent alanında belirtilir.
Google API standartlarına göre kaynaklar artık bir name alanıyla tanımlanır. Örneğin, bir AdClient'in adı accounts/{accountId}/adclients/{adClientId} gibi görünür. Ayrıca, 1.4 sürümünde kaynak kimliği raporlama boyutu olarak kullanılıyordu ancak 2. sürümde bu değer artık çeşitli kaynaklardaki bir reporting_dimension_id alanı aracılığıyla kullanılabilir.
kind alanı tüm kaynaklardan kaldırıldı.

Hesap

name alanı display_name olarak değiştirildi.
timezone alanı, dize yerine google.type.TimeZone olarak değiştirildi.
creation_time alanı (int64 türü), create_time (google.protobuf.Timestamp türü) olarak değiştirildi.
Yeni hesap için kayıt işlemi kapsamında tamamlanması gereken tamamlanmamış görevlerin listesini içeren bir pending_tasks alanı eklendi. Örneğin, faturalandırma profiliniz veya telefon doğrulamanızla ilgili görevler alabilirsiniz.
sub_accounts alanı kaldırıldı. Benzer işlevler, listChildAccounts özel yöntemiyle v2'de de kullanılabilir. Alt hesap ağacının tamamı, listChildAccounts işlevi yinelemeli olarak çağrılarak v2 sürümünde oluşturulabilir.

AdClient

AdSense kullanıcı arayüzünden kaldırılmış olduğu için arc_opt_in alanı kaldırıldı.
supports_reporting alanı, AD_CLIENT_ID raporlama boyutunda kullanılan reklam müşterisinin benzersiz kimliğini temsil eden reporting_dimension_id alanıyla değiştirilir. reporting_dimension_id boşsa AdClient raporlamayı desteklemez.

AdUnit

status alanı, state olarak yeniden adlandırıldı. Ayrıca, ACTIVE durumu artık bu reklam biriminde son yedi gün içinde etkinlik olup olmadığını belirtmez. 2. sürümde ise 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, 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ılmıştır.
AdSense kullanıcı arayüzünde daha önce kaldırılmış olan diğer alanlar da kaldırıldı: 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, name alanının sonunda (son öne eğik çizgiden sonra) bulunabilir.
targeting_info alanı, AdSense kullanıcı arayüzünden kaldırıldığı için kaldırıldı.

Ödeme

payment_date alanı date olarak yeniden adlandırıldı ve dize türü yerine google.type.Date türü olarak değiştirildi.
payment_amount alanı ve payment_amount_currency_code alanı tek bir payment alanında birleştirilmiştir (ör. "¥1.235 JPY", "$1.234,57", "£87,65").

Bildir

2. sürümde, AdSense Management API raporlama verileri artık AdSense kullanıcı arayüzüyle uyumlu hale getirilmiş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 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 parametrelerinin yerini alacak yeni yöntemler eklendi. Not: Sıkıştırma için "Accept-Encoding: gzip" HTTP başlığını kullanmaya devam edebilirsiniz.
Arızi rapor oluşturma işleminde 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ç yaygın aralığı belirtebilirsiniz (ör. TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS ve LAST_30_DAYS) belirtebilir veya date_range değerini CUSTOM olarak ayarlayarak start_date ve end_date belirtebilirsiniz.
- start_date ve end_date alanları, dize türünden google.type.Date türüne değiştirildi. Not: Sonuç olarak, göreli tarih anahtar kelimeleri (ör. "today-6d") artık desteklenmiyor.
- use_timezone_reporting boole alanı, reporting_time_zone ile değiştirildi. reporting_time_zone iki değerden birine sahip olabilir: ACCOUNT_TIME_ZONE veya GOOGLE_TIME_ZONE (PST/PDT anlamına gelir). 2. sürümdeki varsayılan değer ACCOUNT_TIME_ZONE'tir. Bu değer, 1.4 sürümdeki 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 işleminde 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ıldığı için kaldırıldı.

Site

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