تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: locations.questions.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عرض قائمة الأسئلة المقسّمة إلى صفحات وبعض إجاباتها لموقع محدد. لا تكون هذه العملية صالحة إلا إذا تم التحقق من الموقع المحدد.
طلب HTTP
GET https://mybusinessqanda.googleapis.com/v1/{parent=locations/*/questions}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
مطلوب. اسم الموقع الذي تريد جلب أسئلة عنه.
|
معامِلات طلب البحث
| المعلمات |
pageSize |
integer
اختياريّ. عدد الأسئلة المطلوب جلبها لكل صفحة. قيم pageSize التلقائية والحد الأقصى هي 10.
|
pageToken |
string
اختياريّ. إذا تم تحديد هذه السمة، يتم استرداد الصفحة التالية من الأسئلة.
|
answersPerQuestion |
integer
اختياريّ. عدد الإجابات التي يتم استرجاعها لكل سؤال. قيم answersPerQuestion التلقائية والحد الأقصى هي 10.
|
filter |
string
اختياريّ. عامل تصفية يقيد الأسئلة من أجل عرضها. الفلتر الوحيد المتوافق حاليًا هو "ignore_answered=true"
|
orderBy |
string
اختياريّ. الطلب لعرض الأسئلة. تشمل الخيارات الصالحة "updateTime desc" و 'upvocCount 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 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 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)."]]
