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

不可變動。問題的專屬名稱。location/*/questions/* 建立問題時,系統會忽略這個欄位。

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

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