共用方式為

將價格摘要推送至廣告Microsoft

  • 發行項

傳送價格摘要之前：

  • 驗證訊息以確保其符合 交易 XSD 的規範。 這會為您節省來回行程和修正錯誤所需的時間。

  • 使用 GZip 壓縮) ，確定訊息包含少於 100 MB 的未壓縮資料或 10 MB 的壓縮資料 (。 若要減少網路流量，您應該一律傳送壓縮的數據。

  • 請確定您已排入佇列或正在處理的要求少於五個。 您的應用程式應該包含保持在限制範圍內所需的邏輯。 如果您超過限制，要求會失敗，並出現 HTTP 狀態代碼 429。

驗證訊息之後，請將其傳送至 HTTPS POST 要求本文中的 Microsoft。 您傳送要求的網址為：

https://hotels.api.bingads.microsoft.com/api/customers/<customerId>/transactions

將 customerId> 設定<為廣告商的客戶標識碼。

要求必須包含下列標頭：

  • Content-Type：application/xml;charset=utf-8
  • 授權：持有人 <accesstokengoeshere>

您也可以指定下列選擇性標頭：

  • 內容編碼：gzip
    如果您將價格摘要壓縮 (建議) ，請指定此標頭。

  • X-Transaction-ID： <使用者定義標識符>
    廣告商用來唯一識別訊息的不透明使用者定義標識碼。 如果您包含此標頭，標識碼必須符合 Transaction 元素 id 屬性中的識別碼。

下列範例顯示POST要求。

POST https://hotels.api.bingads.microsoft.com/api/customers/abc123/transactions HTTP/1.1
Content-Type: application/xml; charset=utf-8
Host: hotels.api.bingads.microsoft.com

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-05-25T20:44:56-04:00" id="de0be689-d094-406e-
8027-724309deb373">
  <Result>
    <Property>13579</Property>
    <Checkin>2017-06-10</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">159.99</Baserate>
    <Tax currency="USD">20.00</Tax>
    <OtherFees currency="USD">4.00</OtherFees>
    <AllowablePointsOfSale>
      <PointOfSale id="mobile"/>
      <PointOfSale id="desktop"/>
    </AllowablePointsOfSale>
  </Result>
</Transaction>

POST 要求會將訊息放在要處理的佇列中，然後傳回。 您最多可以有五個要求排入佇列或同時處理。 如果您超過限制，要求會失敗，並出現 429。

若要判斷Microsoft是否成功處理訊息，請參閱 Microsoft Advertising Web 應用程式Microsoft飯店中心中的旅館價格廣告摘要狀態。

如果成功將訊息放在佇列) (要求成功，回應的本文會包含 XML 檔，指定從要求本文 (價格摘要) 讀 BytesReceived 取 () 的位元元組數目。

<TxnResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Microsoft.BingAds.BHAC.HotelAdsAPIs.Models">
  <BytesReceived>184381</BytesReceived>
  <FeedId>6165579</FeedId>
</TxnResponse>

元素 FeedId 包含Microsoft產生的標識符，可唯一識別摘要。 交易狀態報表包含此標識碼。

如果要求失敗，回應本文會包含 XML 檔，其中包含錯誤碼和訊息清單，可識別要求失敗的原因。 如需錯誤碼和訊息的清單，請參閱 錯誤碼和訊息。

回應包含 WebRequestActivityId 回應標頭。 標頭包含與記錄檔中要求相關聯的標識碼。 每當要求失敗時，擷取標識碼。 如果您無法解決問題，請在連絡支援服務時提供此標識符。

我需要傳送訊息的頻率

每當價格和可用性變更時，傳送價格摘要。