Google Business Performance API 的
NEW API 方法可擷取單一 API 要求中的多個「DailyMetrics」。
請詳閱
淘汰時間表和從 v4 reportInsights API 方法遷移至 Google Business Profile Performance API 的操作說明。
Method: accounts.locations.questions.list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/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/plus.business.manage
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 some of their answers for a specified location using the \u003ccode\u003eGET\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering by answered status, ordering by update time or upvote count, and specifying the number of questions and answers per page.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with either \u003ccode\u003ehttps://www.googleapis.com/auth/plus.business.manage\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of questions, the total number of questions, and a token for retrieving the next page if available.\u003c/p\u003e\n"],["\u003cp\u003eUses gRPC Transcoding syntax in the URL structure.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.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.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/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` The name of the location to fetch questions for. |\n\n### Query parameters\n\n| Parameters ||\n|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` How many questions to fetch per page. The default and maximum `pageSize` values are 10. |\n| `pageToken` | `string` If specified, the next page of questions is retrieved. |\n| `answersPerQuestion` | `integer` How many answers to fetch per question. The default and maximum `answersPerQuestion` values are 10. |\n| `filter` | `string` A filter constraining the questions to return. The only filter currently supported is \"ignore_answered=true\" |\n| `orderBy` | `string` 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\nIf successful, the response body contains data with the following structure:\nResponse message for QuestionsAndAnswers.ListQuestions\n\n| JSON representation ||\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"questions\": [ { object (/my-business/reference/rest/v4/accounts.locations.questions#Question) } ], \"totalSize\": integer, \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `questions[]` | `object (`[Question](/my-business/reference/rest/v4/accounts.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 one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/plus.business.manage`\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)."]]