Google Business Performance API یک روش API
جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند.
زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به API عملکرد نمایه کسب‌وکار Google را مرور کنید.
Method: locations.questions.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
فهرست صفحه بندی شده سوالات و برخی از پاسخ های آن را برای یک مکان مشخص برمی گرداند. این عملیات تنها در صورتی معتبر است که مکان مشخص شده تأیید شود.
درخواست HTTP
GET https://mybusinessqanda.googleapis.com/v1/{parent=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/business.manage
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 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)."]]
