Aracılığıyla paylaş

İçerik API'sini Kullanmaya Başlama

  • Makale

İçerik API'sini kullanmak için birkaç şeye ihtiyacınız vardır:

  1. Bir Microsoft hesabı
  2. Microsoft Advertising hesabı
  3. Geliştirici belirteci

Microsoft Advertising hesabı almak için adresine https://ads.microsoft.comgidin. Microsoft hesabınızda oturum açmadıysanız, hesabınızda oturum açmak veya bir hesap için kaydolmak üzere yeniden yönlendirilirsiniz. Oturum açtıktan sonra yeni bir Microsoft Advertising hesabına kaydolma seçeneğiniz olur. Kaydolma seçeneğini belirleyin ve Devam'a tıklayın.

Ardından, üretim ortamı için henüz bir Microsoft Advertising geliştirici belirtecine sahip değilseniz Geliştirici Portalı'na gidin. İstek Belirteci'ne tıklayın ve istenen bilgileri sağlayın. API'yi kendi hesabınızı yönetmek için kullanırsanız, belirtecinizi hemen alırsınız; ancak, diğer kişilerin hesaplarını yönetiyorsanız belirtecin alınması beş iş günü kadar sürebilir.

Kimlik bilgilerinizin kimliğini doğrulama

Önemli

1 Haziran 2022'den itibaren Bing Ads API'sini, İçerik API'sini ve Otel API'lerini kullanan üçüncü taraf bir uygulama aracılığıyla oturum açan tüm kullanıcılar için çok faktörlü kimlik doğrulamasına ihtiyacımız olacak.

Yeni msads.manage kapsamı kullanarak kullanıcı onayı almak için uygulamanızı güncelleştirmeniz gerekir. Yeni kapsamı kullanmak için tüm uygulama geliştiricilerin işlem yapması gerekir.

Daha fazla bilgi için multi-factor authentication gereksinim kılavuzuna bakın.

İçerik API'sinde Bing Ads API ile aynı kimlik doğrulama düzenleri kullanılır. OAuth ile Microsoft hesabı kimlik bilgilerinin kimliğini doğrulama hakkında ayrıntılı bilgi için bkz. Microsoft kimlik platformu ile kimlik doğrulaması.

Microsoft hesabı kimlik bilgilerinin kimliğini doğrulamak için .NET, Java veya Python için Bing Ads SDK'sınıkullanabilirsiniz. Erişim belirtecini almak için SDK'yı kullanma hakkında ayrıntılı bilgi için bkz. C# | Java | Python. Kimlik doğrulaması için SDK'yı kullanan bir İçerik API'si örneği için bkz. Ürünleri yönetme örneği.

(Bing Ads SDK'sının İçerik API'sine yönelik arabirimler sağlamadığını unutmayın. Erişim belirtecini almak için SDK'yı yalnızca Microsoft Advertising kampanyaları için SDK kullanıyorsanız kullanmanız gerekir. Aksi takdirde, SDK'yı yükleme yüküne değmeyebilir.)

Kimlik doğrulaması için Bing Ads SDK'sını kullanmıyorsanız, Microsoft hesabı kimlik bilgilerinin kimliğini doğrulamak için OAuth'un nasıl kullanılacağını gösteren bir örnek için bkz. C# dilinde Microsoft Hesabı Kimlik Bilgilerini Doğrulama .

Kimlik bilgilerinizi ve geliştirici belirteçlerinizi nerede kullanabilirsiniz?

Tüm çağrılar şunları belirtmelidir:

  • Geliştirici belirtecinize ayarlanmış DeveloperToken üst bilgisi.
  • Erişim belirtecinize ayarlanmış AuthenticationToken üst bilgisi.

Katalogları diğer müşteriler adına yönetiyorsanız, aşağıdaki üst bilgileri de ayarlamanız gerekir:

  • Mağazasını yönettiğiniz müşterinin müşteri kimliğine ayarlanmış CustomerId üst bilgisi
  • Yönettiğiniz müşteri hesaplarından herhangi birinin hesap kimliğine ayarlanmış CustomerAccountId üst bilgisi (hangi yönetilen hesabın olduğu önemli değildir).

Bunlar ve isteğin ve yanıtın içerebileceği diğer üst bilgiler hakkında bilgi için bkz. Üst bilgiler.

Microsoft Merchant Center'ı API'yi kullanacak şekilde yapılandırma

Microsoft Merchant Center'a (MMC) genel bakış için bkz. Microsoft Merchant Center nedir? Bu konu başlığı, tüm Merchant Center konu başlıklarına ve ilgili videolara bağlantılar içerir.

Henüz yapmadıysanız aşağıdaki adımları tamamlamanız gerekir.

  1. Web sitenizin URL'sini doğrulama ve talep etme Web sitenizin URL'sini doğrulama ve talep etme bölümünde belirtilen web yöneticisi araçlarını almak için bkz. Bing Web Yöneticisi Araçları. Microsoft Advertising için kullandığınız Microsoft hesabıyla oturum açın. Aracı kullanma hakkında daha fazla bilgi için bkz . Web Sitenizin Sahipliğini Doğrulama.
  2. Microsoft Merchant Center mağazası oluşturma
  3. Katalog ekleme

MMC deposu oluşturduğunuzda, işlem sizin için varsayılan bir katalog oluşturur. Depo ve oluşturduğunuz tüm kataloglar API yönetimi için otomatik olarak etkinleştirilir. Mağaza, tüm ürün işlemlerinin (ekleme, güncelleştirme, silme ve alma) varsayılan olarak uygulandığı varsayılan bir katalog içerir. Farklı bir katalog belirtmek için kaynak URL'sindeki bmc-catalog-id sorgu parametresini kullanın.

Katalog eklemek ve etkinleştirmek için Kataloglar kaynağını kullanın. Daha fazla bilgi için bkz. Kataloglarınızı yönetme.

Not

Belirli durumlarda, bir katalog akışını güncelleştirmek için API ve FTP/SFTP kullanabilirsiniz. API'yi FTP/SFTP ile kullanma hakkında bilgi için bkz. API ve FTP/SFTP kullanabilir miyim?

Sonraki Adımlar

ARTıK API'yi kullanmaya başlamaya hazır olduğunuz için aşağıdaki bölümlere bakın.