共用方式為


Cloud Partner 入口網站 API 參考

注意

Cloud Partner 入口網站 API 已與整合,並將繼續在合作夥伴中心運作。 轉換引進了小型變更。 檢閱 這份檔中所列的 CPP API 變更,以確保您的程式代碼在轉換至合作夥伴中心之後繼續運作。 CPP API 應該只用於轉換至合作夥伴中心之前已整合的現有產品:新產品應使用合作夥伴中心提交 API。

Cloud Partner 入口網站 REST API 允許以程式設計方式擷取和操作工作負載、供應專案和發行者配置檔。 API 會使用 Azure 角色型存取控制 (Azure RBAC) 在處理時間強制執行正確的許可權。

此參考提供 Cloud Partner 入口網站 REST API 的技術詳細數據。 本檔中的承載範例僅供參考,而且在新增新功能時可能會變更。

必要條件和考慮

使用 API 之前,您應該先檢閱:

  • 必要 條件 文章,以瞭解如何將服務主體新增至您的帳戶,並取得Microsoft Entra 存取令牌以進行驗證。
  • 可用於呼叫這些 API 的兩 個並行控制 策略。
  • 其他 API 考慮,例如版本設定和錯誤處理。

移轉至合作夥伴中心之後的 CPP API 變更

API 變更描述 影響
POST Publish、GoLive、Cancel 針對已移轉的供應專案,回應標頭的格式不同,但會以相同方式繼續運作,表示要擷取作業狀態的相對路徑。 傳送供應專案的任何對應 POST 要求時,位置標頭有兩種格式之一,視供應專案的移轉狀態而定:
  • 非匯進供應專案
    /api/operations/{PublisherId}${offerId}$2$preview?api-version=2017-10-31
  • 已移轉的供應專案
    /api/publishers/{PublisherId}/offers/{offereId}/operations/408a4835-0000-1000-0000-000000000000?api-version=2017-10-31
GET 作業 針對先前在回應中支援 [通知-電子郵件] 欄位的供應項目類型,此字段將會遭到取代,且不再針對已移轉的供應專案傳回。 針對已移轉的供應項目,我們不會再將通知傳送至要求中指定的電子郵件清單。 相反地,API 服務會與合作夥伴中心的通知電子郵件程式一致以傳送電子郵件。 具體來說,通知會傳送至合作夥伴中心帳戶設定的賣方聯繫人資訊區段中設定的電子郵件位址,通知您作業進度。

檢閱合作夥伴中心帳戶設定的賣方聯繫人資訊一節中設定的電子郵件位址,以確保為通知提供正確的電子郵件。

常見工作

此參考會詳細說明 API,以執行下列一般工作。

供應項目

Operations

發佈應用程式

其他工作

疑難排解

API 版本和更新

更新 什麼資料已變更?
12-2022 CPP 公用 API(版本 2017-10-31)現已更新,以擷取 Marketo 連接器的 clientId 和 clientSecret,同時設定潛在客戶。 在潛在客戶設定期間,您不需要提供接下來的 serverId 欄位。 API 的此更新並不牽涉到任何版本更新或重大變更。