Method: locations.questions.list
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Trả về danh sách các câu hỏi được phân trang và một số câu trả lời cho một vị trí được chỉ định. Thao tác này chỉ hợp lệ nếu vị trí đã chỉ định đã được xác minh.
Yêu cầu HTTP
GET https://mybusinessqanda.googleapis.com/v1/{parent=locations/*/questions}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Tham số |
parent |
string
Bắt buộc. Tên của vị trí cần tìm nạp câu hỏi.
|
Tham số truy vấn
| Tham số |
pageSize |
integer
Không bắt buộc. Số lượng câu hỏi cần tìm nạp trên mỗi trang. Giá trị pageSize mặc định và tối đa là 10.
|
pageToken |
string
Không bắt buộc. Nếu bạn chỉ định, hệ thống sẽ truy xuất trang câu hỏi tiếp theo.
|
answersPerQuestion |
integer
Không bắt buộc. Số lượng câu trả lời cần tìm nạp cho mỗi câu hỏi. Giá trị answersPerQuestion mặc định và tối đa là 10.
|
filter |
string
Không bắt buộc. Bộ lọc ràng buộc các câu hỏi được trả về. Bộ lọc duy nhất hiện được hỗ trợ là "ignore_answered=true"
|
orderBy |
string
Không bắt buộc. Lệnh trả lại các câu hỏi. Các tuỳ chọn hợp lệ bao gồm "nội dung mô tả updateTime" và "upvoteCount desc" để trả về các câu hỏi được sắp xếp giảm dần theo trường được yêu cầu. Thứ tự sắp xếp mặc định là "updateTime theo mô tả".
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Thông báo phản hồi cho AnswersAndAnswers.ListQuestion
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
| Biểu diễn dưới dạng JSON |
{
"questions": [
{
object (Question)
}
],
"totalSize": integer,
"nextPageToken": string
} |
| Trường |
questions[] |
object (Question)
Các câu hỏi bắt buộc,
|
totalSize |
integer
Tổng số câu hỏi được đăng cho vị trí này trên tất cả các trang.
|
nextPageToken |
string
Nếu số lượng câu hỏi vượt quá kích thước trang tối đa được yêu cầu, trường này sẽ được điền sẵn một mã thông báo để tìm nạp trang câu hỏi tiếp theo trong lần gọi tiếp theo. Nếu không còn câu hỏi nào nữa thì trường này sẽ không xuất hiện trong câu trả lời.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/business.manage
Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\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)."]]
