REST Resource: accounts.locations.reviews

資源：評論

僅供輸出。代表地點的評論。

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

資源名稱。「For Review」的格式為 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

星級評等 (滿分五顆星)，五顆星為最高評等。

列舉
STAR_RATING_UNSPECIFIED 不指定。
ONE 1 顆星 (滿分 5 顆星)。
TWO 兩顆星 (滿分五顆星)。
THREE 3 顆星 (滿分 5 顆星)。
FOUR 滿分五顆星的話，我給四顆。
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 這個商家檔案目前無法接收公開更新。Google 已停用這個地點的編輯功能，以防止出現違反政策的內容。
ILLEGAL_BUSINESS_HOURS_EDIT 你的業務類別無法編輯營業時間。
FAKE_ENGAGEMENT 發布內容不得違反不實互動相關政策。不實互動包括誘導性內容、意圖操弄地點評分的內容，以及其他不代表實際體驗的內容。
ADULT_THEMED 發布內容不得違反成人主題內容相關政策。「成人主題」包含非煽情露骨的色情內容和其他成人內容。
SEXUALLY_EXPLICIT 發布內容不得違反情色露骨內容相關政策。「情色露骨內容」包含裸露生殖器官，或者描寫或描述性行為的內容。
ADVERTISING_AND_SOLICITATION 發布內容不得違反廣告或招攬相關政策。「廣告和招攬」包含宣傳或商業內容，或是為了換取利益而發布的內容。
DANGEROUS 發布內容不得違反危險內容相關政策。「危險內容」是指宣傳、鼓吹或助長有害舉動的內容。
GIBBERISH_AND_REPETITIVE 發布內容不得違反難以理解或重複內容相關政策。這類內容違反政策規定，一律禁止發布。
REPETITIVE 發布內容不得違反重複內容相關政策。這類內容違反政策規定，一律禁止發布。
UNCLEAR 難以理解的內容包含隨機組合的字元，以及其他不具意義的內容。這類內容違反政策規定，一律禁止發布。
ILLEGAL 發布內容不得違反非法內容相關政策。
OFF_TOPIC 發布內容不得違反離題內容相關政策。「離題內容」包含一般、政治或社會評論，以及用來抒發個人不滿的內容。
OFFENSIVE 發布內容不得違反令人反感的內容相關政策。「令人反感的內容」是指可能致使他人合理地感到極度憤怒、受辱或遭到輕蔑的內容。
VIOLENCE_AND_GORE 發布內容不得違反暴力血腥內容相關政策。「暴力或血腥內容」包含涉及人類或動物的極端內容，呈現寫實的暴力行為、血腥畫面、肢體或內臟。
CHILD_SAFETY 發布內容不得違反兒童安全相關政策。這類內容涉及的題材會將兒童暴露於風險中、剝削或虐待兒童，或是利用 Google 服務危害兒童。
HARASSMENT 發布內容不得違反騷擾相關政策。「騷擾」包含霸凌、威脅、性化，或令人感到自身安全受到威脅的內容。
HATE_SPEECH 發布內容不得違反仇恨言論相關政策。「仇恨言論」包含針對受保護的特徵或是其他系統性歧視或邊緣化相關特質，煽動或苟同暴力、歧視、詆毀或激起仇恨。
IMPERSONATION 發布內容不得違反冒用他人身分相關政策。「冒用他人身分」包含利用假身分來誤導他人或取得不當利益的行為。
MISINFORMATION 發布內容不得違反不實資訊相關政策。「不實資訊」包含可能對個人、商家或社會造成重大傷害的虛假或錯誤資訊。
MISREPRESENTATION 發布內容不得違反不實陳述或行為相關政策。「不實陳述或行為」包含為了獲取不當利益而做出誤導性陳述或行為，或是隱匿相關資訊。
OBSCENITY_AND_PROFANITY 發布內容不得違反猥褻或不雅用語相關政策。「猥褻與不雅用語」包含當地社會視為令人反感或粗俗的用語或手勢。
PERSONAL_INFO 發布內容不得違反個人資訊相關政策。「個人資訊」是指您的或他人的私人或機密資訊，例如信用卡資料、病歷或政府核發的身分證件。
REGULATED_GOODS_AND_SERVICES 發布內容不得違反管制商品和服務相關政策。這類內容包含為銷售受當地法規約束的產品或服務，而製作的行動號召或促銷訊息。
GENERIC_VANDALISM 發布內容不得違反濫用或劣質內容相關政策。
GENERIC_FRAUD 發布內容不得違反欺詐內容與行為政策。欺詐內容會刻意誤導或欺騙他人。
PHOTOS_AND_VIDEOS_CRITERIA 發布內容不得違反相片和影片的準則要求。
MODERATION_ERROR 處理發布內容時發生錯誤。
PRIVACY 發布內容不得違反「Google 地圖使用者提供內容」隱私權政策。
GENERIC_VIOLATION 您的內容違反政策規定，禁止發布。
GENERIC_QUALITY 發布內容不得違反內容品質相關政策。
IDENTITY_CHANGE 你所做的變更與建立的商家差異過大。這違反 YouTube 政策。
GEOGRAPHIC_LOCATION_CHANGE 表示商家實際地理位置 (地址或經緯度) 在建立商家檔案後有顯著變更。

ReviewMediaItem

代表與評論相關聯的媒體項目 (相片或影片)。

JSON 表示法 
{
  "thumbnailUrl": string,
  "thumbnailLabel": string,
  "videoUrl": string
}
欄位
thumbnailUrl

string

僅供輸出。相片的 FIFE 網址，或 videoUrl 存在時的影片縮圖。
thumbnailLabel

string

僅供輸出。作者提供的 thumbnailUrl 標籤。
videoUrl

string

僅供輸出。可播放的影片網址。

方法

deleteReply

 刪除指定評論的回覆。

get

 傳回指定評論。

list

 傳回指定地點的分頁評論清單。

updateReply

 更新指定評論的回覆。