フィードのセマンティクスを確認する
レビュー フィードのセマンティクスは若干ニュアンスが異なります。
スナップショット レビュー フィードの場合:
- レビュー フィード内のサービス プロバイダが LSA プロバイダ データベースに存在しない場合、そのプロバイダのレビューは取り込まれません。
- レビュー フィード内のサービス プロバイダが、現在 LSA プロバイダ データベースに存在する場合、そのプロバイダのレビューは次のように処理されます。
- フィード内のレビューに対応するレビューが LSA ストレージに存在しない場合は、作成する必要があります。
- フィード内のレビューについて、対応するレビューが LSA ストレージに存在する場合、レビューは新しい情報で更新されます。
- フィードに含まれていないレビューについては、対応するレビューが LSA ストレージに存在する場合、そのレビューは削除されます。
- レビュー フィードにないサービス プロバイダが LSA プロバイダ データベースに現在存在する場合、そのプロバイダのレビューは削除され、プロバイダのサービス提供は停止されます。
- レビューが 1 件もないプロバイダも、広告を配信するにはレビュー フィードにエントリが必要です（省略できません）。（レビュー フィードのサンプル - listingId 2 を参照）
増分はレビュー フィードではサポートされていません。各プロフィール フィードには、対応するレビュー フィードが必要です。
レビューのエラー処理
レビュー フィード アイテムが無効な場合、そのフィード アイテムの処理はスキップされ、残りの有効なフィード アイテムの処理が続行されます。
レビュー フィードが無効な場合（スキーマに準拠していないなど）、レビュー フィード全体の処理を停止します。
フィールドを確認する
| フィールド名 | タイプ | 説明 | 例 | 必須 | 制約 |
|---|---|---|---|---|---|
| serviceProviderId | 数値 | リスティング（サービス プロバイダ）の一意の識別子 | 12345 | ○ | int64 に収まる必要があります |
| ratingCount | integer | 検証済みのユーザー評価の数 | 10 | ○ | 0 以上でなければなりません。 |
| 著者 | 文字列 | レビューの投稿者の名前 | 「Jack L.」 | いいえ | |
| reviewId | 文字列 | レビューの一意の ID。各レビューに固有の ID がない場合は、サードパーティが各レビューの固有の ID（レビュー テキストとユーザーのハッシュなど）を生成する必要があります。少なくとも、1 つのプロバイダのすべてのレビュー間で固有である必要があります。 | 「123」 | ○ | |
| reviewText | 文字列 | 著者が書いたレビュー テキスト | 「よくできました。」 | いいえ | |
| 評価 | integer | 評価（1 ～ 5 の整数） | 4 | ○ | 1 ～ 5 の整数を指定する必要があります。 |
| serviceLocationCity | 文字列 | サービスが実施された都市 | 「ニューヨーク」 | いいえ | |
| reviewTimestampMicros | integer | クチコミが投稿されたときのタイムスタンプ（マイクロ秒形式）。 | 1.45142E+15 | いいえ | |
| serviceTimestampMicros | integer | サービスが終了したときのタイムスタンプ（マイクロ秒単位）。 | 1.45132E+15 | いいえ | |
| language | 文字列 | ISO 639-1 言語コード（小文字、2 文字）で指定されたレビュー テキストの言語。プロバイダのターゲティング言語と一致している必要があります。 | 「en」 | いいえ | 関連付けられたプロバイダに指定されたターゲティング言語と一致している必要があります。指定しない場合のデフォルトは「en」です。 |
| category | オブジェクト | カテゴリ構造 | いいえ | ||
| category->categoryId | enum | サービスのカテゴリ（LSA 分類） | 「garage_door_pro」 | いいえ | |
| category->task | enum | サービス（LSA 分類）のジョブタイプ（タスク） | 「ガレージドアを修理する」 | いいえ | |
| confirmedCustomer | ブール値 | 確認済みの顧客（見込み顧客を含む）からのレビューの場合 | TRUE | いいえ |