製品オファーの状態を取得するにはどうすればよいですか?

[アーティクル]
10/04/2023

カタログまたはストアで製品オファーを追加または更新すると、オファーは編集レビューを行う前に最初の検証を経ます。このプロセスには最大 36 時間かかることがあります。オファーがレビュープロセスに合格したかどうかを確認するには、 Status リソースを使用します。

注:

ステータスが [不承認] または [警告] に設定されている製品の一覧を取得するには、「製品オファーの状態を取得する」を参照してください。

リソースの取得に使用するベース URI を次に示します Status 。

https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/

製品オファーの状態を取得するには、次のテンプレートをベース URI に追加します。

{bmcMerchantId}/catalogs/{catalogId}/status

BMC ストア ID に設定 {bmcMerchantId} し、状態を取得する製品オファーを含むカタログの ID に設定 {catalogId} します。

各 HTTP 要求には、ユーザーの OAuth アクセストークンと開発者トークンが含まれている必要があります。ユーザーのアクセストークンを指定するには、 AuthenticationToken ヘッダーを設定します。開発者トークンを指定するには、 DeveloperToken ヘッダーを設定します。

他の顧客に代わってカタログを管理する場合は、次の設定を行う必要があります。

管理しているストアを持つ顧客の顧客 ID に対する CustomerId ヘッダー。
管理する顧客のアカウントのアカウント ID に対する CustomerAccountId ヘッダー (管理対象アカウントは関係ありません)。

レポートをダウンロードするために、アクセストークンまたは開発者トークンを指定する必要はありません。状態を取得するには、それらを指定する必要があります。

既定では、Content API は JSON オブジェクトを使用して状態を表します。 XML を使用するには、 alt クエリパラメーターを XML に設定します。

結果の URL に HTTP GET 要求を送信します。応答には、過去 30 日間にレビュープロセスに合格または失敗したオファーの数を含む Status オブジェクトが含まれています。オファーがレビューに失敗した場合、リソースには、 Status オファーが失敗した理由を説明するレポートのダウンロードに使用できる URL が含まれています。

オブジェクトの例 Status を次に示します。

{
  "catalogId": 12345,
  "publishedCount": 80,
  "rejectedCount": 6,
  "rejectionReportUrl": "https://merchantcenter.bingads.microsoft.com/api/Public/DownloadFeedReport?token=..."
}

レポートは、失敗したオファーを識別しますが、レポートが参照している更新プログラムの特定に使用できるタイムスタンプまたはバージョン管理情報は提供しません。たとえば、2 日前にオファーをアップロードし、昨日更新した場合、問題が 2 日前にアップロードされたバージョンと昨日アップロードされたバージョンに関連しているかどうかはわかりません。ただし、レポートの [オファースニペット] 列のアイテムの属性を使用して、報告されるアイテムのバージョンを推測できる場合があります。

レポートファイルは ZIP 圧縮されているため、レポートを読み取るためにファイルを解凍する必要があります。システムが格納できるレポートの数に制限はありません。ただし、レポートが格納される時間の長さは未定義です。レポートの内容については、「レポート形式」を参照してください。

カタログに関連付けられているアクティビティによっては、レポートが大きくなる場合があります。レポートは、必要以上に頻繁に要求しないでください。推奨される間隔は、1 時間に 1 回以下です。

カタログの状態を取得し、レポートをダウンロードする方法を示すコード例については、「カタログ状態レポートのダウンロード」を参照してください。

レポートの例を次に示します。

"Catalog Name","Catalog Id","Store Id","Upload Time"
"Default Catalog","1234","5678","04/21/2016 01:59:06"

"Item Id","Message","Type","Values","Offer Snippet"
"SKU1234","The product URL should be a sub-path of the store's domain. ","Error","",";eBay Motors>Parts & Accessories>Car & Truck Parts>Brakes>Brake Hoses>;http://contentapis.cloudapp.net/sku123;http://i.ebayimg.com/00/s/NzY4WDI5Mg==/z/irkAAOxyB9RS14Rj/$_1.JPG?set_id=880000500F;24.25;-1;;"
"SKU5678","The product URL should be a sub-path of the store's domain. ","Error","",";;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=Ma8674a23cc755995efecf822b3836f07o0&pid=Api;1205;-1;;"
"SKU0987","The product URL should be a sub-path of the store's domain. ","Error","",";Apparel & Accessories > Clothing > Outerwear;http://v-vagancclaimedapi.cloudapp.net/;http://google.com/;1;-1;;"
"SKU6543","The price field is required.","Error","","Mens T-shirt;N/A;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=OIP.Ma8674a23cc755995efecf822b3836f07o0&pid=Api;N/A"
"SKU2435","The offer expiration date is in the past.","Error","","full product title;Apparel & Accessories > Clothing > Outerwear;http://v-vagancclaimedapi.cloudapp.net/;http://google.com/;1.00"
"SKU8675","The price field is required.","Error","","Mens T-shirt;N/A;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=OIP.Ma8674a23cc755995efecf822b3836f07o0&pid=Api;N/A"

製品オファーの状態を取得するにはどうすればよいですか?

その他のリソース