REST Resource: accounts.locations.reviews

リソース: Review

出力専用。ビジネスについてのクチコミを表します。

JSON 表現 
{
  "name": string,
  "reviewId": string,
  "reviewer": {
    object (Reviewer)
  },
  "starRating": enum (StarRating),
  "comment": string,
  "createTime": string,
  "updateTime": string,
  "reviewReply": {
    object (ReviewReply)
  },
  "reviewMediaItems": [
    {
      object (ReviewMediaItem)
    }
  ]
}
フィールド
name

string

リソース名。クチコミの場合は accounts/{accountId}/locations/{locationId}/reviews/{reviewId} という形式になります。
reviewId

string

暗号化された一意の ID です。
reviewer

object (Reviewer)

レビューを書いた人です。
starRating

enum (StarRating)

クチコミの評価です。
comment

string

マークアップ付きの書式なしテキストによるクチコミの本文です。
createTime

string (Timestamp format)

クチコミが投稿されたときのタイムスタンプです。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

クチコミが最後に変更されたときのタイムスタンプです。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
reviewReply

object (ReviewReply)

このクチコミに対するビジネスのオーナーまたは管理者による返信です。
reviewMediaItems[]

object (ReviewMediaItem)

出力専用。クチコミに関連付けられたメディア アイテム。

審査担当者

クチコミの投稿者を表します。

JSON 表現 
{
  "profilePhotoUrl": string,
  "displayName": string,
  "isAnonymous": boolean
}
フィールド
profilePhotoUrl

string

クチコミ投稿者のプロフィール写真へのリンクです。isAnonymous が false の場合にのみ入力されます。
displayName

string

クチコミ投稿者の名前です。isAnonymous が false の場合にのみクチコミ投稿者の実名が入力されます。
isAnonymous

boolean

クチコミ投稿者が匿名のままにするよう設定しているかどうかを表します。

StarRating

星 5 つを最も高い評価とする評価です。

列挙型
STAR_RATING_UNSPECIFIED 指定されていません。
ONE 最高で星 5 つのうちの 1 つ星です。
TWO 最高で星 5 つのうちの 2 つ星です。
THREE 最高で星 5 つのうちの 3 つ星です。
FOUR 最高で星 5 つのうちの 4 つ星です。
FIVE 最高の評価です。

ReviewReply

クチコミに対するビジネスのオーナーまたは管理者による返信を表します。

JSON 表現 
{
  "comment": string,
  "updateTime": string,
  "reviewReplyState": enum (State),
  "policyViolation": enum (PolicyViolation)
}
フィールド
comment

string

マークアップが付いた書式なしテキストとしての返信の本文です。最大長は 4,096 バイトです。
updateTime

string (Timestamp format)

出力専用。返信が最後に変更されたときのタイムスタンプです。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
reviewReplyState

enum (State)

出力専用。クチコミへの返信の状態。
policyViolation

enum (PolicyViolation)

省略可。出力専用。否承認の原因となったポリシー違反。reviewReplyState が REJECTED の場合にのみ入力されます。

州

クチコミへの返信の審査状態を表します。

列挙型
REVIEW_REPLY_STATE_UNSPECIFIED 状態が指定されていないことを示します。
PENDING 返信が審査待ちであることを示します。
REJECTED 返信が拒否されたことを示します。
APPROVED 返信が承認されたことを示します。

PolicyViolation

標準化されたポリシー違反を表します。今後、新しい値が追加される可能性があります。クライアントは、不明な値を処理する準備をする必要があります。

列挙型
POLICY_VIOLATION_UNSPECIFIED 指定されていないポリシー違反を表します。
ACCOUNT_RESTRICTED_AND_SUSPENDED このビジネス プロフィールに関連付けられた Google アカウントが制限されたため、ビジネス プロフィールが停止されました。
ACCOUNT_RESTRICTED_AND_EDIT_REJECTED このビジネス プロフィールに関連付けられた Google アカウントが制限されているため、編集内容が承認されませんでした。ACCOUNT_RESTRICTED_AND_SUSPENDED とは異なり、ビジネス プロフィール自体は有効なままで、停止されません。
ASSOCIATED_ACCOUNT_SUSPENDED このビジネス プロフィールに関連付けられた Google アカウントは、良好な状態ではありません。このアカウントに関連付けられたビジネス プロフィールは停止されています。
BUSINESS_INELIGIBLE お客様のビジネスはビジネス プロフィールの掲載対象として適格ではありません。
OWNERSHIP_REVOKED このビジネス プロフィールは、別の Google アカウントによって申請されています。このプロフィールは管理できなくなりました。
LOCATION_SUSPENDED このビジネス プロフィールは停止されています。
LOCATION_DISABLED このビジネス プロフィールは無効になっています。
LOCATION_VERIFICATION_REQUIRED このビジネス プロフィールのオーナー確認は行われていません。
PO_BOX ビジネスの住所に私書箱は使用できないため、ビジネス プロフィールは停止されました。
GOOGLE_PAY_SUSPENSION お支払いプロファイルに関連付けられたビジネス プロフィールは停止されています。
EDITING_RESTRICTION このビジネス プロフィールは現在、一般公開の更新を受け取ることが制限されています。ポリシーに違反するコンテンツを防ぐため、この場所の編集は無効になっています。
ILLEGAL_BUSINESS_HOURS_EDIT この業種では営業時間を編集できません。
FAKE_ENGAGEMENT 虚偽のエンゲージメントに関する Google のポリシーに違反するコンテンツは許可されません。虚偽のエンゲージメントには、報酬に基づくコンテンツ、場所の評価を操作することを意図したコンテンツ、実体験に基づいていないコンテンツなどがあります。
ADULT_THEMED アダルト向けコンテンツに関する Google のポリシーに違反するコンテンツは許可されません。アダルト向けコンテンツには、露骨でない性的なコンテンツとその他のアダルト コンテンツの両方が含まれます。
SEXUALLY_EXPLICIT 性的描写が露骨なコンテンツに関する Google のポリシーに違反するコンテンツは許可されません。性的描写が露骨なコンテンツには、性器の露出、および性行為の描写や記述が含まれます。
ADVERTISING_AND_SOLICITATION 宣伝または勧誘に関する Google のポリシーに違反するコンテンツは許可されません。宣伝と勧誘には、営利目的のコンテンツや、利益と引き換えに投稿されるコンテンツが含まれます。
DANGEROUS 危険なコンテンツに関する Google のポリシーに違反するコンテンツは許可されません。危険なコンテンツとは、有害な行為を奨励、促進、または助長するコンテンツのことです。
GIBBERISH_AND_REPETITIVE 不明確なコンテンツや繰り返し投稿されたコンテンツに関する Google のポリシーに違反するコンテンツは許可されません。不明確なコンテンツや繰り返し投稿されたコンテンツがあると、Google がユーザーに提供する有益な情報の割合が低下するためです。
REPETITIVE 繰り返し投稿されたコンテンツに関する Google のポリシーに違反するコンテンツは許可されません。繰り返し投稿されたコンテンツには、1 つ以上のアカウントによって複数回追加された同一または類似のコンテンツが含まれます。
UNCLEAR 不明確なコンテンツに関する Google のポリシーに違反しているコンテンツは許可されません。不明確なコンテンツには、文字のランダムな羅列やその他の意味を持たないコンテンツが含まれます。
ILLEGAL 違法なコンテンツに関する Google のポリシーに違反するコンテンツは許可されません。
OFF_TOPIC 関連性のないコンテンツに関する Google のポリシーに違反するコンテンツは許可されません。関連性のないコンテンツには、一般的、政治的、社会的な論評や個人的な不満が含まれます。
OFFENSIVE 不適切なコンテンツに関する Google のポリシーに違反するコンテンツは許可されません。不適切なコンテンツとは、他者に強烈な怒り、侮辱、または冒とくの感情をかなり引き起こす可能性のあるコンテンツのことです。
VIOLENCE_AND_GORE 暴力的または残虐なコンテンツに関するポリシーに違反するコンテンツは許可されません。暴力的または残虐なコンテンツには、人または動物の生死にかかわる危険な内容で、暴力行為、流血、身体の部位、臓器の生々しい動きを表現しているコンテンツが含まれます。
CHILD_SAFETY 子供の安全に関する Google のポリシーに違反するコンテンツは許可されません。こうしたコンテンツには、子供を危険にさらしたり、子供を搾取、虐待したり、Google サービスを利用して子供を危険にさらしたりする内容のコンテンツが含まれます。
HARASSMENT ハラスメントに関する Google のポリシーに違反するコンテンツは許可されません。これには、誰かをいじめる、脅迫する、性的対象として見る、または誰かに身の危険を感じさせるコンテンツが含まれます。
HATE_SPEECH ヘイトスピーチに関する Google のポリシーに違反するコンテンツは許可されません。ヘイトスピーチには、暴力、差別、誹謗を助長または容認したり、守られるべき特性または構造的な差別や排斥に結び付く他の特性に基づいて憎悪を煽ったりする行為が含まれます。
IMPERSONATION なりすましに関する Google のポリシーに違反するコンテンツは許可されません。なりすましには、他者を欺いたり不正な利益を得たりする目的で、別人になりすます行為が含まれます。
MISINFORMATION 誤った情報に関する Google のポリシーに違反するコンテンツは許可されません。誤った情報には、個人、企業または社会に対して大きな危害をもたらす可能性がある、虚偽情報や不正確な情報が含まれます。
MISREPRESENTATION 不実表示に関する Google のポリシーに違反するコンテンツは許可されません。不実表示には、不正な利益を得る目的で使われる、誤解を招く表現や省略が含まれます。
OBSCENITY_AND_PROFANITY わいせつまたは冒とく的な表現に関する Google のポリシーに違反するコンテンツは許可されません。わいせつおよび冒とく的な表現のコンテンツには、地域において社会的に不適切または下品であると見なされる言葉やジェスチャーが含まれます。
PERSONAL_INFO 個人情報に関する Google のポリシーに違反するコンテンツは許可されません。個人情報には、クレジット カード情報や医療記録、政府発行の身分証明書など、ご自身や他人の個人情報や機密情報が含まれます。
REGULATED_GOODS_AND_SERVICES 規制対象の商品やサービスに関する Google のポリシーに違反するコンテンツは許可されません。こうしたコンテンツには、各地域で規制の対象となる商品やサービスの販売を促すフレーズや特典も含まれます。
GENERIC_VANDALISM 不適切なコンテンツまたは質の低いコンテンツに関する Google のポリシーに違反しているコンテンツは許可されません。
GENERIC_FRAUD 詐欺的なコンテンツと虚偽の振る舞いに関する Google のポリシーに違反しているコンテンツは許可されません。詐欺的なコンテンツとは、故意に他者を欺いているコンテンツを指します。
PHOTOS_AND_VIDEOS_CRITERIA 写真と動画に関する条件を満たしていないコンテンツは許可されません。
MODERATION_ERROR コンテンツの処理中にエラーが発生しました。
PRIVACY Google マップユーザーの投稿コンテンツに関するプライバシー ポリシーに違反するコンテンツは許可されません。
GENERIC_VIOLATION お客様のコンテンツは Google のポリシーに違反しているため、許可されません。
GENERIC_QUALITY 質の低いコンテンツに関する Google のポリシーに違反しているコンテンツは許可されません。
IDENTITY_CHANGE お客様が行った変更は、作成されたビジネスと大きく異なります。これはポリシー違反に該当します。
GEOGRAPHIC_LOCATION_CHANGE ビジネスの物理的な地理的位置（住所または緯度/経度）が、プロフィールの作成時から大幅に変更されていることを示します。

ReviewMediaItem

クチコミに関連付けられたメディア アイテム（写真または動画）を表します。

JSON 表現 
{
  "thumbnailUrl": string,
  "thumbnailLabel": string,
  "videoUrl": string
}
フィールド
thumbnailUrl

string

出力専用。写真の FIFE URL。videoUrl が存在する場合は動画のサムネイル。
thumbnailLabel

string

出力専用。thumbnailUrl の作成者が指定したラベル。
videoUrl

string

出力専用。再生可能な動画の URL。

メソッド

deleteReply

 指定したクチコミへの返信を削除します。

get

 指定したクチコミを返します。

list

 指定したビジネスについて、ページ分けされたクチコミの一覧を返します。

updateReply

 指定したクチコミへの返信を更新します。