المرجع: سؤال
تمثل سؤالاً واحدًا وبعض الإجابات عنه.
تمثيل JSON |
---|
{ "name": string, "author": { object ( |
الحقول | |
---|---|
name |
غير قابل للتغيير. تمثّل هذه السمة الاسم الفريد للسؤال. location/*/questions/* سيتم تجاهل هذا الحقل في حال ضبطه أثناء إنشاء السؤال. |
author |
النتائج فقط. تمثل هذه الخاصية كاتب السؤال. |
upvoteCount |
النتائج فقط. تمثّل هذه السمة عدد التصويتات المؤيّدة للسؤال. |
text |
مطلوب. تمثل هذه السمة نص السؤال. يجب أن يحتوي على ثلاث كلمات على الأقل وأن يكون إجمالي الطول أكبر من أو يساوي 10 أحرف. ويجب ألّا يزيد عدد الأحرف عن 4096 حرفًا. |
createTime |
النتائج فقط. الطابع الزمني لوقت كتابة السؤال. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
updateTime |
النتائج فقط. الطابع الزمني لوقت آخر تعديل على السؤال. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
topAnswers[] |
النتائج فقط. قائمة بالإجابات عن السؤال، مرتّبة حسب التصويتات المؤيّدة. قد لا تكون هذه القائمة عبارة عن قائمة كاملة بالإجابات استنادًا إلى مَعلمات الطلب (answersPerQuestion). |
totalAnswerCount |
النتائج فقط. إجمالي عدد الإجابات المنشورة عن هذا السؤال. |
المؤلّف
تمثيل مؤلف سؤال أو إجابة
تمثيل JSON |
---|
{
"displayName": string,
"profilePhotoUri": string,
"type": enum ( |
الحقول | |
---|---|
displayName |
الاسم المعروض للمستخدم |
profilePhotoUri |
معرّف الموارد المنتظم (URI) لصورة الملف الشخصي للمستخدِم. |
type |
تمثّل هذه السمة نوع المستخدم المؤلف. |
AuthorType
يشير ذلك المصطلح إلى تعداد لنوع المستخدم المؤلف.
عمليات التعداد | |
---|---|
AUTHOR_TYPE_UNSPECIFIED |
ويجب عدم استخدام هذه العلامة. |
REGULAR_USER |
مستخدم عادي |
LOCAL_GUIDE |
مرشد محلي |
MERCHANT |
مالك/مدير الموقع |
الإجابة
لتمثيل إجابة عن سؤال
تمثيل JSON |
---|
{
"name": string,
"author": {
object ( |
الحقول | |
---|---|
name |
النتائج فقط. الاسم الفريد لمواقع الإجابات/*/questions/*/answers/* |
author |
النتائج فقط. تمثل هذه الخاصية كاتب الجواب. سيتم ضبطه فقط أثناء عمليات القائمة. |
upvoteCount |
النتائج فقط. تمثّل هذه السمة عدد التصويتات المؤيّدة للإجابة. |
text |
مطلوب. تمثل هذه السمة نص الإجابة. يجب أن يحتوي على حرف واحد بدون مسافات بيضاء على الأقل. ويجب ألّا يزيد عدد الأحرف عن 4096 حرفًا. |
createTime |
النتائج فقط. الطابع الزمني لوقت كتابة الإجابة. لا يتم استرداده إلا أثناء استرجاع ListResponse. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
updateTime |
النتائج فقط. الطابع الزمني لوقت آخر تعديل على الإجابة. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
الطُرق |
|
---|---|
|
لإضافة سؤال للموقع الجغرافي المحدّد |
|
يؤدي هذا الإجراء إلى حذف سؤال محدّد من تأليف المستخدم الحالي. |
|
عرض قائمة الأسئلة المقسّمة إلى صفحات وبعض إجاباتها لموقع محدد. |
|
لتعديل سؤال محدّد كتبه المستخدم الحالي. |