Aracılığıyla paylaş

Bulut İş Ortağı Portalı API Başvurusu

  • Makale

Not

Bulut İş Ortağı Portalı API'leri ile tümleşiktir ve İş Ortağı Merkezi'nde çalışmaya devam edecektir. Geçiş küçük değişiklikler sağlar. İş Ortağı Merkezi'ne geçiş yaptıktan sonra kodunuzun çalışmaya devam ettiğinden emin olmak için bu belgede listelenen CPP API'lerinde Yapılan Değişiklikler'i gözden geçirin. CPP API'leri yalnızca İş Ortağı Merkezi'ne geçiş öncesinde zaten tümleştirilmiş olan mevcut ürünler için kullanılmalıdır; yeni ürünler İş Ortağı Merkezi gönderim API'lerini kullanmalıdır.

Bulut İş Ortağı Portalı REST API'leri, iş yüklerinin, tekliflerin ve yayımcı profillerinin program aracılığıyla alınmasına ve değiştirilmesine olanak sağlar. API'ler, işleme zamanında doğru izinleri zorunlu kılmak için Azure rol tabanlı erişim denetimini (Azure RBAC) kullanır.

Bu başvuru, Bulut İş Ortağı Portalı REST API'leri için teknik ayrıntıları sağlar. Bu belgedeki yük örnekleri yalnızca başvuru amaçlıdır ve yeni işlevler eklendikçe değiştirilebilir.

Önkoşullar ve dikkat edilmesi gerekenler

API'leri kullanmadan önce şunları gözden geçirmelisiniz:

İş Ortağı Merkezi'ne geçiş sonrasında CPP API'lerine yapılan değişiklikler

API Açıklamayı değiştir Etki
POST Yayımlama, GoLive, İptal Geçirilen teklifler için yanıt üst bilgisi farklı bir biçime sahiptir, ancak işlem durumunu almak için göreli bir yol belirterek aynı şekilde çalışmaya devam eder. Teklif için ilgili POST isteklerinden herhangi birini gönderirken, Teklifin geçiş durumuna bağlı olarak Konum üst bilgisi iki biçimden birine sahiptir:
  • Göç edilmeyen teklifler
    /api/operations/{PublisherId}${offerId}$2$preview?api-version=2017-10-31
  • Geçirilen teklifler
    /api/publishers/{PublisherId}/offers/{offereId}/operations/408a4835-0000-1000-0000-000000000000?api-version=2017-10-31
GET İşlemi Yanıtta daha önce 'notification-email' alanını destekleyen teklif türleri için bu alan kullanım dışı bırakılacak ve geçirilen teklifler için artık döndürülmeyecek. Geçirilen teklifler için artık isteklerde belirtilen e-posta listesine bildirim göndermeyeceğiz. Bunun yerine API hizmeti, e-posta göndermek için İş Ortağı Merkezi'ndeki bildirim e-posta işlemiyle hizalanır. Özellikle, işlem ilerleme durumunu bildirmek için İş Ortağı Merkezi'ndeki Hesap ayarlarınızın Satıcı iletişim bilgileri bölümünde ayarlanan e-posta adresine bildirimler gönderilir.

Bildirimler için doğru e-postanın sağlandığından emin olmak için İş Ortağı Merkezi'ndeki Hesap ayarlarınızın Satıcı iletişim bilgileri bölümünde ayarlanan e-posta adresini gözden geçirin.

Genel görevler

Bu başvuru, aşağıdaki yaygın görevleri gerçekleştirmek için API'lerin ayrıntılarını içerir.

Teklifler

Operations

Uygulama yayımlama

Diğer görevler

Sorun giderme

API sürümleri ve güncelleştirmeleri

Güncelleştir Neler değişti?
12-2022 CPP genel API'si (sürüm 2017-10-31), müşteri müşteri adaylarını yapılandırırken clientId ve clientSecret for Marketo bağlayıcısını yakalayacak şekilde güncelleştirildi. Müşteri adayı yapılandırması sırasında, bundan sonra serverId alanını sağlamanız gerekmez. API'ye yapılan bu güncelleştirme, herhangi bir sürüm güncelleştirmesi veya hataya neden olan değişiklikleri içermez.