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

Sürüm Notları

Bu sayfada AdSense Management API'nin sürüm notları yer almaktadı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üm oluşturma şemasına göre bu sürüm, ayrı ara sürümlerde yayınlanan yeni işlevler yerine zaman içinde ek (geriye dönük uyumlu) işlevler içerecek şekilde güncellenecektir.

2025-10-02

Raporlar

Metriklerin trafik kaynağına (ör. "Google", "Bing", "Facebook", "Diğer") göre dökümünün alınmasına olanak tanıyan TRAFFIC_SOURCE boyutu eklendi. Daha fazla bilgi için Trafik kaynağı dökümü başlıklı makaleyi inceleyin.

2025-05-06

PolicyIssues

Kullanımdan kaldırılan policyTopics[].must_fix alanı (önceki güncellemeye bakın) artık her zaman false olarak ayarlanacak.

2025-02-24

PolicyIssues

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

2024-04-03

PolicyIssues

Bir hesapta mevcut politika ihlalleri ve uyarılar hakkında rapor oluşturmak için yeni bir koleksiyon eklendi.

2023-06-19

Ödemeler

payments.list artık premium yayıncıların ödemeleriyle ilgili ayrıntıları döndürüyor.

2023-06-13

Raporlar

Reklam birimi olmayan birimlerin (ör. alakalı 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ılmasına olanak tanıyan PAGE_URL boyutu eklendi (bazı uyarılar için Sayfa URL'sine göre 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ştirilmiş 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ştirilmiş projeler tarafından kullanılabileceğini unutmayın.
Kaynağa etkin alanı 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 ayrıştırmasına olanak tanıyan HOSTED_AD_CLIENT_ID boyutunu ekledik.

2022-05-03

AdClient

Alma yöntemi eklendi.

Raporlar

getSaved yöntemi eklendi.

UrlChannels

Alma yöntemi eklendi.

2022-03-31

Hesap

Etkin olmayan hesaplar artık API tarafından state alanıyla birlikte döndürülüyor. Bu alan, hesabın durumunu gösteriyor.

AdClient

Hesap değişikliklerine benzer şekilde, etkin olmayan reklam istemcileri artık API tarafından döndürülüyor. Bu istemcilerde, state alanı reklam istemcisinin durumunu gösteriyor.

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 ayrı bir ödeme hesabına aktarılacağı YouTube içerik üreticileri için geliştirilmiş AdSense deneyiminin aşamalı olarak kullanıma sunulmasından önce yapılmıştır. YouTube ödeme bilgileri, YouTube kazançları için özel bir ödeme hesabınız olduğunda ödeme listesi yönteminden de döndürülür. YouTube kazançları aşağıdaki kaynak adı biçimine sahip olur:
- accounts/{account}/payments/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ının kaynak adları değişmeden kalır:
- accounts/{account}/payments/unpaid, ödenmemiş (mevcut) AdSense kazançları için kullanılır.
- accounts/{account}/payments/yyyy-MM-dd (ücretli AdSense kazançları için).

2021-06-30

Bildirin

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. v1.4'te aynı adlara ancak farklı üyelere sahip (kullanımdan kaldırılmış) boyutlar olduğunu unutmayın. v2'de eklenen iki boyut, v1.4'te bulunanlardan farklıdır.

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

Genel (General)

v1.4'teki tüm kullanımdan kaldırılan 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ı ile tanımlanıyor. Örneğin, bir AdClient'ın adı accounts/{accountId}/adclients/{adClientId} gibi görünür. Ayrıca, v1.4'te kaynak kimliği bir raporlama boyutu olarak kullanılıyordu ancak v2'de bu değer artık çeşitli kaynaklardaki 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ı, dizeden 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 bir hesap için kayıt işlemi kapsamında tamamlanması gereken, tamamlanmamış görevlerin listesi olan bir pending_tasks alanı eklendi. Örneğin, görevler faturalandırma profiliniz veya telefon doğrulamasıyla ilgili olabilir.
sub_accounts alanı kaldırıldı. Benzer işlevler, v2'de listChildAccounts özel yöntemiyle kullanılabilir. Tam alt hesap ağacı, v2'de listChildAccounts işlevi tekrar tekrar çağrılarak oluşturulabilir.

AdClient

AdSense kullanıcı arayüzünden kaldırıldığı için arc_opt_in alanı 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ştirilir. reporting_dimension_id boşsa AdClient raporlamayı desteklemiyor demektir.

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ı göstermez. v2'de, 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 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 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 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 türü dize türünden google.type.Date türüne değiştirildi.
payment_amount alanı ve payment_amount_currency_code alanı tek bir payment alanında birleştirildi (ör. "¥1.235 JPY", "$1.234,57", "£87,65").

Bildirin

2. sürümle birlikte, AdSense Management API raporlama verileri artık AdSense kullanıcı arayüzüyle uyumlu. Bu nedenle, AdMob ve YouTube mülkleri artık desteklenmiyor. Ayrıca API yalnızca 3 yıl öncesine kadar olan rapor verilerini destekleyecektir.
Metadata.dimensions kaynağı ve Metadata.metrics kaynağı kaldırıldı.
Raporun CSV sürümünü oluşturmak için yeni yöntemler eklendi. Bu yöntemler, v1.4'teki sorgu parametrelerinin yerini alıyor. Not: Sıkıştırma için "Accept-Encoding: gzip" HTTP üstbilgisini kullanmaya devam edebilirsiniz.
Bazı alanlar, geçici rapor oluşturma işleminde 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 ve LAST_30_DAYS) veya date_range değerini CUSTOM olarak ayarlayarak 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. "today-6d") artık desteklenmiyor.
- use_timezone_reporting Boole alanı, reporting_time_zone ile değiştirildi. Bu alan, ACCOUNT_TIME_ZONE veya GOOGLE_TIME_ZONE (PST/PDT anlamına gelir) olmak üzere iki değerden birini alabilir. v2'deki varsayılan değer ACCOUNT_TIME_ZONE'dir ve 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 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 getirmek için eklendi.
state alanı, sitenin aşağıdaki durumlardan herhangi birinde olup olmadığını gösterir: 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.