Bing Ads API Hizmetleri Protokolü

Bing Ads API uygulamanızı web hizmetlerini destekleyen herhangi bir dilde yazabilirsiniz. Her web hizmeti için bir web hizmetleri açıklama dili (WSDL) belgesi tanımlanır. WSDL, bir web hizmetinin sunduğu işlemleri ve istemcinin gönderdiği ve işlemlerden aldığı istek ve yanıt iletilerinin biçimini tanımlar. İstek ve yanıt iletileri, istemcinin işlemle değiştirip yaptığı verilerin adlarını ve türlerini tanımlar. WSDL'ler hakkında daha fazla bilgi için bkz. W3C WSDL belirtimi.

Bing Ads API'leri için SOAP

Bing Ads API'sinde Basit Nesne Erişim Protokolü (SOAP) desteklenir. C# ve Java gibi bazı diller, WSDL'den ara sunucu sınıfları oluşturan araçlar sağlar. Seçtiğiniz dil ara sunucu sınıfları oluşturmak için bir araç sağlamıyorsa, kendi proxy sınıflarınızı veya SOAP zarflarınızı oluşturmanız gerekir. Proxy sınıflarını oluşturmak için, kullanmak istediğiniz hizmetin WSDL belgesinin web adresine ihtiyacınız vardır. Microsoft Advertising korumalı alanı ve üretim ortamlarının her birinde benzersiz bir adres vardır. Adresler, WSDL'nin büyük bir Bing Ads API sürümüne özgü sürüm numarasını da içerir. En son Bing Ads API sürümünün üretim ve korumalı alan hizmeti WSDL'leri için bkz. Bing Ads API Web Hizmeti Adresleri.

SOAP XML Öğe Sırası

BIR SOAP isteği iletisi oluşturduğunuzda, SOAP gövdesindeki öğelerin sırası kritiktir. Öğelerin web hizmetleri açıklama dilinde (WSDL) tanımlanan sırada olması gerekir. Gerekli öğeler uygun değilse, çağrı başarısız olur. İsteğe bağlı öğeler sıra dışıysa, çağrı başarısız olabilir veya öğeler yoksayılır. Öğelerin doğru sırasını gösteren WSDL söz dizimi, başvuru içeriğinde belgelenen her istek iletisine, yanıt iletisine ve veri nesnesine eklenir. Ayrıca, her istek ve yanıt iletisi örnek bir SOAP zarfı gösterir.

Not

XML büyük/küçük harfe duyarlıdır. Değer adları için doğru büyük/küçük harf kullanmanız gerekir. C# gibi kesin olarak yazılan programlama dilleri, derlemeden önce doğru büyük/küçük harfe sahip olduğunuzdan emin olun. Doğru durum kullanılmadıysa diğer diller size derleme hatası vermeyebilir; ancak kod çalışma zamanında başarısız olur.

Kısmi Başarı

Bing Ads API'si ekleme, güncelleştirme ve silme işlemleri için kısmi tamamlamaları destekler; Eklediğiniz, güncelleştirdiğiniz veya sildiğiniz nesneler listesindeki nesnelerden biri başarısız olursa, işlem koleksiyondaki diğer kişiler için başarılı olabilir. Örneğin, GetKeywordsByIds işlemi gibi tanımlayıcıların listesini alan bir Get işlemini çağırdığınızda ve listedeki tanımlayıcılardan biri geçerli değilse, işlem başarılı olur ve geçersiz istek tanımlayıcısına karşılık gelen yanıt öğesi sıfır olur.

Kısmi Güncelleştirme

Kampanya Yönetimi Kısmi Güncelleştirme

Kısmi güncelleştirme çoğu için desteklenir, ancak tüm kampanya yönetimi veri nesneleri için desteklenmez. Örneğin, bir ExpandedTextAdöğesinin Text özelliğini güncelleştirirken yalnızca Kimlik ve Metin öğelerini belirtmeniz gerekir. Reklam düzenleme durumu gibi salt okunur öğeler sıfır veya boş bırakılmalıdır. Aksi açıkça belgelenmediği sürece, isteğe bağlı öğeler boş bırakılabilir ve mevcut ayarları değiştirilmez.

Kısmi güncelleştirme reklam uzantıları için desteklenmez. Güncelleştirme isteğiyle birlikte gönderilmeyen tüm isteğe bağlı öğeler ilgili reklam uzantısından silinir.

Müşteri Yönetimi Kısmi Güncelleştirme

Müşteri yönetimi hizmeti varlıkların tam güncelleştirmesini gerçekleştirir, bu nedenle belgelenen gerekli özelliklere ek olarak, sıfır veya boş olmasını istemediğiniz tüm isteğe bağlı özellikler için değerler sağlamanız gerekir.

Not

Bu kuralın bir özel durumu, herhangi bir nesnenin ForwardCompatibilityMap öğesidir. Örneğin, ReklamverenHesap'ınForwardCompatibilityMap öğesini sağlamazsanız hizmet, anahtar ve değer çiftleri tarafından temsil edilecek özellikleri güncelleştirmez veya geçersiz kılmaz.

Varlık Tanımlayıcılarınızı Yerel Olarak Depolama

Hesabınızın ve kampanya varlıklarınızın yerel bir mağazasını tutmalısınız. Özellikle hesaplarınızın, müşterilerinizin, kampanyalarınızın, reklam gruplarınızın ve anahtar sözcüklerinizin tanımlayıcılarını yerel olarak depolamanız gerekir. Çağrıların çoğu varlığın tanımlayıcısını gerektirir. Tanımlayıcıyı depolarsanız, tanımlayıcıyı almak için gereken çağrıyı ortadan kaldırırsınız.

Örneğin, kampanya yönetimi çağrılarının çoğu bir hesap tanımlayıcısı gerektirir. Hesap tanımlayıcısını almak için müşteri yönetim hizmetini kullanabilirsiniz. Ancak, hizmeti tekrar tekrar çağırmak yerine, sonraki çağrılarda kullanabilmeniz için hesap tanımlayıcısını yerel olarak depolayın.

Web Hizmeti Çağrıları Yapma ile İlgili Ek Yükü Yönetme

Aşağıda, her web hizmeti çağrısıyla ilişkili işlem süresindeki ek yük maliyetleri yer alır.

• Web hizmetine HTTPS bağlantısı kurma.
• Kullanıcı adı ve parolanın kimliğini doğrulama.
• Geliştirici belirtecini doğrulama.

Bu maliyetler, tek bir öğeyi veya bir dizi öğeyi işlemeniz durumunda ortaya çıkar. Ek yükü en aza indirmek için, genel olarak mümkün olduğunca çok öğeyi tek bir çağrıda işlemeyi denemelisiniz. Örneğin, güncelleştirmek istediğiniz her kampanya için UpdateCampaigns çağrısı yapmak yerine, güncelleştirmek istediğiniz birden çok kampanya için yalnızca bir kez arayın. Büyük ölçekli verileri yönetmek için, özellikle de bir hesaptaki birden çok reklam grubuna veya kampanyaya reklam ve anahtar sözcük eklemeniz veya güncelleştirmeniz gerekiyorsa Toplu hizmeti kullanmanız gerekir. Toplu hizmet, verileri TSV veya CSV dosyası olarak indirmenize, gerektiğinde değiştirmenize ve ardından değişikliklerinizi karşıya yüklemenize olanak tanır. Toplu hizmeti kullanma hakkında daha fazla bilgi için bkz. Toplu İndirme ve Karşıya Yükleme.

Bir web hizmetiyle bağlantı kurmanın maliyetleri nedeniyle, gerekli olduğu sürece bağlantıyı korumanız gerekir. Örneğin, birden çok rapor istemeniz gerekiyorsa, tüm raporlama hizmeti işlem çağrıları için aynı raporlama hizmeti istemci nesnesini kullanın. Hizmete artık ihtiyacınız kalmadığında bağlantıyı açıkça kapatın.

Azaltmayı İşleme

Son derece yüksek hacimli kullanımı azaltma, tüm Microsoft Advertising müşterileri için adil kullanımı korur.

Ad Insight API'si

Ad Insight hizmeti için azaltma, herhangi bir kullanıcının bir dakika içinde api'ye gerçekleştirebileceği çağrı sayısını sınırlar.

Müşteri düzeyinde, müşterinin müşteri verilerine gerçekleştirebileceği çağrı sayısı, 60 saniyelik bir pencereyle kayan bir protokol kullanılarak kısıtlanır.

Hizmet çağrısı sınırını aşarsanız aşağıdaki hatayı görürsünüz:

• Sayısal Hata Kodu: 117
• Sembolik Hata Kodu: CallRateExceeded
• İleti: Bir dakika içinde yapmanıza izin verilen çağrı sayısını aştınız. Lütfen dakika başına yaptığınız arama sayısını azaltın.

Bu hatayı gözlemlediğinizde, 60 saniye bekledikten sonra isteği sınırın altında yeniden gönderebilirsiniz.

Toplu API

Toplu hizmet DownloadCampaignsByAccountIds, DownloadCampaignsByCampaignIds ve GetBulkUploadUrl için yapabileceğiniz istek sayısını sınırlar. Hizmet sınırlarının ayrıntıları dahilidir ve değiştirilebilir.

Hizmet arama sınırına ulaştıysanız aşağıdaki hatayı görürsünüz:

• Sayısal Hata Kodu: 4204
• Sembolik Hata Kodu: BulkServiceNoMoreCallsPermittedForTheTimePeriod
• İleti: Geçerli süre boyunca bu hesap için toplu yükleme veya indirme çağrılarına izin verilmez. Toplu yükleme sınırınıza ulaştıysanız toplu indirme işlemleri hala kullanılabilir veya tam tersi olabilir.

Bu hatayı gözlemlerseniz, 15 dakikaya kadar bekledikten sonra isteğinizi yeniden gönderebilirsiniz. Daha fazla ayrıntı için bkz . Toplu İndirme En İyi Yöntemleri ve Toplu Yükleme En İyi Yöntemleri.

Ayrıca üretimde toplu yükleme için dosya başına boyut sınırının 100 MB ve en fazla 4 milyon satır olduğunu unutmayın. Korumalı Alan için sınır 20.000 satırdır.

Kampanya Yönetimi API'si

Kampanya Yönetimi hizmeti için azaltma, herhangi bir kullanıcının bir dakika içinde api'ye gerçekleştirebileceği çağrı sayısını sınırlar.

Müşteri düzeyinde, müşterinin müşteri verilerine gerçekleştirebileceği çağrı sayısı, 60 saniyelik bir pencereyle kayan bir protokol kullanılarak kısıtlanır.

Hizmet arama sınırına ulaştıysanız aşağıdaki hatayı görürsünüz:

• Sayısal Hata Kodu: 117
• Sembolik Hata Kodu: CallRateExceeded
• İleti: Bir dakika içinde yapmanıza izin verilen çağrı sayısını aştınız. Lütfen dakika başına yaptığınız arama sayısını azaltın.

Bu hatayı gözlemlediğinizde, 60 saniye bekledikten sonra isteği sınırın altında yeniden gönderebilirsiniz.

Raporlama API'si

Raporlama hizmeti SubmitGenerateReportRequest için yapabileceğiniz istek sayısını sınırlar. Hizmet sınırlarının ayrıntıları dahilidir ve değiştirilebilir.

Hizmet arama sınırına ulaştıysanız aşağıdaki hatayı görürsünüz:

• Sayısal Hata Kodu: 207
• Sembolik Hata Kodu: ConcurrentRequestOverLimit
• İleti: Eşzamanlı rapor isteği sayısı üst sınırına zaten ulaştınız. Lütfen önceki raporlar tamamlanana kadar bekleyin ve ardından yeni bir istek göndermeyi deneyin.

Bu hatayı gözlemlerseniz lütfen önceki raporlar tamamlanana kadar bekleyin ve ardından yeni bir istek göndermeyi deneyin.

Ayrıca Bkz

Bing Ads API Web Hizmeti Adresleri
Bing Ads API'lerine Genel Bakış