Google Business Performance API 的
NEW API 方法可擷取單一 API 要求中的多個「DailyMetrics」。
請詳閱
淘汰時間表和從 v4 reportInsights API 方法遷移至 Google Business Profile Performance API 的操作說明。
Method: locations.questions.list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
傳回分頁式的問題清單,以及指定位置的部分答案。只有在指定位置已通過驗證時,這項作業才會生效。
HTTP 要求
GET https://mybusinessqanda.googleapis.com/v1/{parent=locations/*/questions}
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
parent |
string
必要欄位。要擷取問題的位置名稱。
|
查詢參數
參數 |
pageSize |
integer
選用設定。每頁要擷取的問題數量。pageSize 的預設值與最大值為 10。
|
pageToken |
string
選用設定。如有指定,系統會擷取下一頁的問題。
|
answersPerQuestion |
integer
選用設定。每個問題要擷取的答案。answersPerQuestion 的預設值與最大值為 10。
|
filter |
string
選用設定。篩選器會限制要傳回的問題。目前唯一支援的篩選器是「ignore_answered=true」
|
orderBy |
string
選用設定。要發還問題的訂單。有效選項包括「updateTime desc」和「upvoteCount desc」,即可傳回依要求欄位遞減排序的問題。預設排序順序為「updateTime desc」。
|
回應主體
FAQAndAnswers.ListQuestions 回應訊息
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
{
"questions": [
{
object (Question )
}
],
"totalSize": integer,
"nextPageToken": string
} |
欄位 |
questions[] |
object (Question )
要求的問題
|
totalSize |
integer
針對這個位置在所有網頁中張貼的問題總數。
|
nextPageToken |
string
如果問題數量超過要求的頁面大小上限,這個欄位會填入符記,以便在後續呼叫中擷取下一頁的問題。如果沒有其他問題,系統就不會在回覆中顯示這個欄位。
|
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/business.manage
詳情請參閱 OAuth 2.0 總覽。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eRetrieves a paginated list of questions and answers for a verified Google Business location.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by unanswered questions and sorting by update time or upvote count.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes the questions, total question count, and a token for retrieving subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: locations.questions.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListQuestionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nReturns the paginated list of questions and some of its answers for a specified location. This operation is only valid if the specified location is verified.\n\n### HTTP request\n\n`GET https://mybusinessqanda.googleapis.com/v1/{parent=locations/*/questions}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|---------------------------------------------------------------------|\n| `parent` | `string` Required. The name of the location to fetch questions for. |\n\n### Query parameters\n\n| Parameters ||\n|----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Optional. How many questions to fetch per page. The default and maximum `pageSize` values are 10. |\n| `pageToken` | `string` Optional. If specified, the next page of questions is retrieved. |\n| `answersPerQuestion` | `integer` Optional. How many answers to fetch per question. The default and maximum `answersPerQuestion` values are 10. |\n| `filter` | `string` Optional. A filter constraining the questions to return. The only filter currently supported is \"ignore_answered=true\" |\n| `orderBy` | `string` Optional. The order to return the questions. Valid options include 'updateTime desc' and 'upvoteCount desc', which will return the questions sorted descendingly by the requested field. The default sort order is 'updateTime desc'. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for QuestionsAndAnswers.ListQuestions\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"questions\": [ { object (/my-business/reference/qanda/rest/v1/locations.questions#Question) } ], \"totalSize\": integer, \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `questions[]` | `object (`[Question](/my-business/reference/qanda/rest/v1/locations.questions#Question)`)` The requested questions, |\n| `totalSize` | `integer` The total number of questions posted for this location across all pages. |\n| `nextPageToken` | `string` If the number of questions exceeds the requested max page size, this field is populated with a token to fetch the next page of questions on a subsequent call. If there are no more questions, this field is not present in the response. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/business.manage`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]