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

汎用フィードドロップボックスの使用

汎用フィードドロップボックスを使用すると、環境ごとに 1 つのドロップボックスに複数のフィードタイプをアップロードできます。このガイドでは、汎用ドロップボックスの使用方法について説明します。また、使用する予定のフィードに適したガイドへのリンクも記載しています。

で確認できます。（ドキュメントの「フィードのエクスポート（エンドツーエンド）」またはフィード（開始条件）のセクションを参照）。

汎用ドロップボックスでは、次の 2 つの個別のアップロードが必要です。

記述子ファイル: アップロードするフィードタイプを記述します。
フィードファイル: 実際のフィードの内容

記述子フィールドの構造化

記述子ファイルは、Google のシステムに知らせるためにアップロードされます。表示されます。これにより、フィードを正しく検証して処理できます。「フィードコンテンツの前にアップロードし、次の命名要件があります。

記述子ファイルには .filesetdesc.json のファイル拡張子を使用する必要があります。
各記述子ファイル名は一意である必要があります。また、アップロード間で再利用することはできません。ファイル名には、生成タイムスタンプとフィード名を含めることをおすすめします。
- 例: offer_1524606581.filesetdesc.json
各記述子ファイルには、関連するフィード名の最新フィード内のすべてのデータファイルを一覧表示する必要があります。

message FilesetDescriptor {
  // The timestamp at which this feed was generated, in Unix time format
  // (seconds since the epoch). (required)
  int64 generation_timestamp = 1;

  // Identifies the name of this feed. (required)
  string name = 2;

  // Paths (relative to the dropbox root) specifying data files included in this
  // feed. (required)
  repeated string data_file = 3;
}

name フィールドで使用できる値は次のとおりです。

2 つのシャードを含む商品フィードの JSON 記述子ファイルの例を次に示します。

{
  "generation_timestamp": 1524606581,
  "name": "promote.offer",
  "data_file": [
    "offers_1524606581_1.json",
    "offers_1524606581_2.json"
  ]
}

フィードコンテンツの構造

記述子ファイルをアップロードしたら、すべてのフィードファイルをアップロードします。フィード構成ファイルに対応するフィードデータタイプの使用します。ファイル名とパスの場所（ドロップボックスに含まれるもの）と完全に data_file フィールド。ファイルがない場合、名前が正しくない場合、別の場所にアップロードすると、フィード全体が表示されます。

これらのフィードデータファイルの内容は、記述子ファイルで指定されたフィードです。

各フィードのファイル名は一意である必要があります。また、別のアップロードで再利用することはできません。ファイル名には、生成タイムスタンプとシャード番号（増分 ID）を含めることをおすすめします。

例: offers_1524606581_1.json

フィードファイルのサイズとアップロード頻度

フィードファイルのサイズは圧縮後 200 MB 未満にしてください。
解凍した各データファイルのサイズは 2 GB 未満にする必要があります。
ほとんどの統合では、単一シャードを使用するだけで済みます。シャードの使用は最小限に抑える必要があります。1 つのフィードにつきシャードの最大数は 1,000 です。
1 つのシャードで送信された個々のレコードを、今後のフィードの同じシャード番号で送信する必要はありません。
パフォーマンスを向上させるには、シャード間でデータを均等に分割して、すべてのシャードをシャードファイルはサイズが同程度です。
必要に応じて、gzip を使用してフィードを圧縮します。ただし、個別フィードシャードがあります

トラブルシューティングとデバッグ

ファイル（記述子とフィードファイル）をアップロードしたら、 [Feed History] ダッシュボード（ドキュメント）。（[履歴] > [フィード] に移動）して、フィードの取り込みの進行状況を確認できます。

記述子ファイルに入力した name を [フィード名] 列で探して、フィードを見つけます。

フィードが取り込まれたら（ステータスが Success または Fail の場合）、その行でエラーと警告の詳細を確認できます。