تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
REST Resource: accounts.locations.questions
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المرجع: سؤال
تمثل سؤالاً واحدًا وبعض الإجابات عنه.
| تمثيل JSON |
{
"name": string,
"author": {
object (Author)
},
"upvoteCount": integer,
"text": string,
"createTime": string,
"updateTime": string,
"topAnswers": [
{
object (Answer)
}
],
"totalAnswerCount": integer
} |
| الحقول |
name |
string
النتائج فقط. تمثّل هذه السمة الاسم الفريد للسؤال. accounts/*/locations/*/questions/*
|
author |
object (Author)
النتائج فقط. تمثل هذه الخاصية كاتب السؤال.
|
upvoteCount |
integer
النتائج فقط. تمثّل هذه السمة عدد التصويتات المؤيّدة للسؤال.
|
text |
string
تمثل هذه السمة نص السؤال. يجب أن يحتوي على ثلاث كلمات على الأقل وأن يكون إجمالي الطول أكبر من أو يساوي 10 أحرف. ويجب ألّا يزيد عدد الأحرف عن 4096 حرفًا.
|
createTime |
string (Timestamp format)
النتائج فقط. الطابع الزمني لوقت كتابة السؤال. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
|
updateTime |
string (Timestamp format)
النتائج فقط. الطابع الزمني لوقت آخر تعديل على السؤال. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
|
topAnswers[] |
object (Answer)
النتائج فقط. قائمة بالإجابات عن السؤال، مرتّبة حسب التصويتات المؤيّدة. قد لا تكون هذه القائمة عبارة عن قائمة كاملة بالإجابات استنادًا إلى مَعلمات الطلب (answersPerQuestion).
|
totalAnswerCount |
integer
النتائج فقط. إجمالي عدد الإجابات المنشورة عن هذا السؤال.
|
الطُرق |
|
|
لإضافة سؤال للموقع الجغرافي المحدّد |
|
|
يؤدي هذا الإجراء إلى حذف سؤال محدّد من تأليف المستخدم الحالي. |
|
|
عرض قائمة الأسئلة المقسّمة إلى صفحات وبعض إجاباتها لموقع محدد. |
|
|
لتعديل سؤال محدّد كتبه المستخدم الحالي. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Question resource represents a single question asked about a specific location, including details like the author, text, upvotes, and answers.\u003c/p\u003e\n"],["\u003cp\u003eIt includes fields for tracking creation and update times, along with the total number of answers received.\u003c/p\u003e\n"],["\u003cp\u003eQuestions can be created, deleted, listed, and updated through dedicated methods provided in the API.\u003c/p\u003e\n"],["\u003cp\u003eAnswers to questions are sorted by upvotes and a limited number are returned based on request parameters.\u003c/p\u003e\n"]]],[],null,["# REST Resource: accounts.locations.questions\n\n- [Resource: Question](#Question)\n - [JSON representation](#Question.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Question\n------------------\n\nRepresents a single question and some of its answers.\n\n| JSON representation ||\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"name\": string, \"author\": { object (/my-business/reference/rest/v4/Author) }, \"upvoteCount\": integer, \"text\": string, \"createTime\": string, \"updateTime\": string, \"topAnswers\": [ { object (/my-business/reference/rest/v4/accounts.locations.questions.answers#Answer) } ], \"totalAnswerCount\": integer } ``` |\n\n| Fields ||\n|--------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The unique name for the question. accounts/\\*/locations/\\*/questions/\\* |\n| `author` | `object (`[Author](/my-business/reference/rest/v4/Author)`)` Output only. The author of the question. |\n| `upvoteCount` | `integer` Output only. The number of upvotes for the question. |\n| `text` | `string` The text of the question. It should contain at least three words and the total length should be greater than or equal to 10 characters. The maximum length is 4096 characters. |\n| `createTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Output only. The timestamp for when the question was written. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n| `updateTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Output only. The timestamp for when the question was last modified. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n| `topAnswers[]` | `object (`[Answer](/my-business/reference/rest/v4/accounts.locations.questions.answers#Answer)`)` Output only. A list of answers to the question, sorted by upvotes. This may not be a complete list of answers depending on the request parameters (answersPerQuestion) |\n| `totalAnswerCount` | `integer` Output only. The total number of answers posted for this question. |\n\n| Methods ------- ||\n|----------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------|\n| ### [create](/my-business/reference/rest/v4/accounts.locations.questions/create) | Adds a question for the specified location. |\n| ### [delete](/my-business/reference/rest/v4/accounts.locations.questions/delete) | Deletes a specific question written by the current user. |\n| ### [list](/my-business/reference/rest/v4/accounts.locations.questions/list) | Returns the paginated list of questions and some of its answers for a specified location. |\n| ### [patch](/my-business/reference/rest/v4/accounts.locations.questions/patch) | Updates a specific question written by the current user. |"]]
