REST Resource: locations.questions

資源：Question

代表單一問題及部分答案。

JSON 表示法 
{
  "name": string,
  "author": {
    object (Author)
  },
  "upvoteCount": integer,
  "text": string,
  "createTime": string,
  "updateTime": string,
  "topAnswers": [
    {
      object (Answer)
    }
  ],
  "totalAnswerCount": integer
}
欄位
name

string

無法變更。問題的專屬名稱。位置/*/問題/* 如果在建立問題時設定了此欄位，系統會忽略此欄位。
author

object (Author)

僅供輸出。問題的作者。
upvoteCount

integer

僅供輸出。問題的認同票數。
text

string

必要欄位。問題的文字。其中應包含至少 3 個字詞，且總長度大於或等於 10 個字元。長度上限為 4096 個半形字元。
createTime

string (Timestamp format)

僅供輸出。寫入問題時的時間戳記。

RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

僅供輸出。上次修改問題時的時間戳記。

RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
topAnswers[]

object (Answer)

僅供輸出。問題的答案清單，依認同票數排序。視要求參數 (answersPerQuestion) 而定，此清單並不一定完整
totalAnswerCount

integer

僅供輸出。這個問題張貼的答案總數。

作者

代表問題或答案的作者

JSON 表示法 
{
  "displayName": string,
  "profilePhotoUri": string,
  "type": enum (AuthorType)
}
欄位
displayName

string

使用者的顯示名稱
profilePhotoUri

string

使用者的個人資料相片 URI。
type

enum (AuthorType)

作者的使用者類型。

AuthorType

顯示作者的使用者類型，以列舉表示。

列舉
AUTHOR_TYPE_UNSPECIFIED 請勿使用此屬性。
REGULAR_USER 一般使用者。
LOCAL_GUIDE 在地嚮導
MERCHANT 位置的擁有者/管理員

解答

代表問題的答案

JSON 表示法 
{
  "name": string,
  "author": {
    object (Author)
  },
  "upvoteCount": integer,
  "text": string,
  "createTime": string,
  "updateTime": string
}
欄位
name

string

僅供輸出。答案位置的專屬名稱/*/questions/*/answers/*
author

object (Author)

僅供輸出。答案的作者。只會在清單作業期間設定。
upvoteCount

integer

僅供輸出。答案的認同票數。
text

string

必要欄位。答案文字。當中至少要有一個非空白字元。長度上限為 4096 個半形字元。
createTime

string (Timestamp format)

僅供輸出。撰寫答案的時間戳記。只在 ListResponse 擷取期間擷取。

RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

僅供輸出。上次修改答案的時間戳記。

RFC3339 世界標準時間「Zulu」格式的時間戳記，採用奈秒解析度，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

方法

create

 在指定位置新增問題。

delete

 刪除目前使用者所撰寫的特定問題。

list

 針對指定位置傳回分頁式問題清單和部分答案。

patch

 更新目前使用者所撰寫的特定問題。