Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند.
زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به API عملکرد نمایه کسب‌وکار Google را مرور کنید.
Method: accounts.locations.questions.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
فهرست صفحه بندی شده سوالات و برخی از پاسخ های آن را برای یک مکان مشخص برمی گرداند.
درخواست HTTP
GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/questions
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
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" است. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
پیام پاسخ برای QuestionsAndAnswers.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 مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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)."]]
