このページは Cloud Translation API によって翻訳されました。

Content API for Shopping の互換性

このガイドを使用して、Merchant API を既存の Content API for Shopping の実装。

始める

詳しくは、Merchant API の設計をご覧ください。 Merchant API とそのサブ API。

Merchant API の使用を開始するには、リクエスト URL を次のように変更してください。形式:

https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…

クイックスタートガイドをご覧ください。詳しくは、Merchant API リファレンスをご覧ください。

gRPC のサポート

Merchant API は gRPC と REST をサポートしています。次を使用: Merchant API 用の gRPC と Content API for Shopping 用の REST を同時に使用できます。あります。

Merchant API クライアントライブラリを使用するには、 gRPC。

詳細については、gRPC の使用をご覧ください。情報です。

互換性

このガイドでは、Merchant API 全体に適用される一般的な変更について説明します。詳しくは、特定の機能の変更については、次のガイドをご覧ください。

Merchant API は既存の Content API for Shopping と連携するように設計されていますバージョン 2.1 の機能です。

たとえば、Merchant Inventories API を既存の Content API for Shopping v2.1 の広告枠と products の実装。マイページ Content API for Shopping を使って新しいローカル広告をアップロードできます（販売している商品） Merchant Inventories API を使用して、 LocalInventory リソースを作成して管理できます。

バッチリクエスト

Merchant API は、customBatchメソッド Content API for Shoppingその場合は、バッチリクエストの送信リクエストできます。customBatch を使用する場合 Merchant API でこの機能が必要な場合は、理由をフィードバックをお寄せください。

識別子

Google の API 改善に関する原則に沿って、Google は Merchant API リソースの識別子に変更を加えました。

名前が Id に置き換わる

すべての Merchant API リソースは、一意の識別子として name フィールドを使用します。

呼び出しで name フィールドを使用する方法の例を次に示します。

POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert

この新しい name フィールドは、すべての読み取り / 書き込み操作のリソース ID として書き込み呼び出しを行うことをおすすめします

name フィールドで返される値は、新しい ID 形式を使用します。

たとえば、getName() メソッドを実装して name を name を構築する代わりに出力を変数として格納し、自動的に取得されます。

新しい ID の形式

Merchant API では、リソース ID は次の形式を使用します。 channel~language~feedLabel~offerId

Content API リソースで、ID の各値の間で ~ ではなく : が使用されていました。 channel:language:feedLabel:offerId

すべての Merchant API 呼び出しは、~ あります。レスポンスからの新しい形式を保存して、予測します。

子リソースの親フィールド

Merchant API では、すべての子リソースに parent フィールドがあります。次を使用: parent フィールド。子を挿入するリソースの name を指定します。親リソース全体を渡すのではなく親リソース全体を渡しますparent を使用することもできます。その parent の子リソースを一覧表示する list メソッドを含むフィールド。

たとえば、特定の商品のローカル在庫を一覧表示するには、商品の name parent フィールドの list メソッドを呼び出します。この場合、指定された product はリクエストの parent です。 LocalInventory リソースが含まれます。

型

ここでは、Merchant API サブ API で共有される一般的なタイプをいくつか示します。

価格

Merchant Common パッケージの Price の変更点は次のとおりです。

	Content API	販売者 API
金額フィールド	`value:string`	`amountMicros:int64`
通貨フィールド	`currency:string`	`currencyCode:string`

Price の金額がマイクロ単位で記録されるようになりました。100 万マイクロが、通貨の標準単位に相当します

Content API for Shopping では、Price は使用します。

金額フィールド名が value から amountMicros に変更されました

通貨フィールド名が currency から currencyCode に変更されました。「 ISO 4217 のままです。

クイックスタート

アカウント管理を移行する