REST Resource: locations.questions

المرجع: سؤال

تمثل سؤالاً واحدًا وبعض الإجابات عنه.

تمثيل JSON 
{
  "name": string,
  "author": {
    object (Author)
  },
  "upvoteCount": integer,
  "text": string,
  "createTime": string,
  "updateTime": string,
  "topAnswers": [
    {
      object (Answer)
    }
  ],
  "totalAnswerCount": integer
}
الحقول
name

string

غير قابل للتغيير. تمثّل هذه السمة الاسم الفريد للسؤال. location/*/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

النتائج فقط. إجمالي عدد الإجابات المنشورة عن هذا السؤال.

المؤلّف

تمثيل مؤلف سؤال أو إجابة

تمثيل JSON 
{
  "displayName": string,
  "profilePhotoUri": string,
  "type": enum (AuthorType)
}
الحقول
displayName

string

الاسم المعروض للمستخدم
profilePhotoUri

string

معرّف الموارد المنتظم (URI) لصورة الملف الشخصي للمستخدِم.
type

enum (AuthorType)

تمثّل هذه السمة نوع المستخدم المؤلف.

AuthorType

يشير ذلك المصطلح إلى تعداد لنوع المستخدم المؤلف.

عمليات التعداد
AUTHOR_TYPE_UNSPECIFIED ويجب عدم استخدام هذه العلامة.
REGULAR_USER مستخدم عادي
LOCAL_GUIDE مرشد محلي
MERCHANT مالك/مدير الموقع

الإجابة

لتمثيل إجابة عن سؤال

تمثيل JSON 
{
  "name": string,
  "author": {
    object (Author)
  },
  "upvoteCount": integer,
  "text": string,
  "createTime": string,
  "updateTime": string
}
الحقول
name

string

النتائج فقط. الاسم الفريد لمواقع الإجابات/*/questions/*/answers/*
author

object (Author)

النتائج فقط. تمثل هذه الخاصية كاتب الجواب. سيتم ضبطه فقط أثناء عمليات القائمة.
upvoteCount

integer

النتائج فقط. تمثّل هذه السمة عدد التصويتات المؤيّدة للإجابة.
text

string

مطلوب. تمثل هذه السمة نص الإجابة. يجب أن يحتوي على حرف واحد بدون مسافات بيضاء على الأقل. ويجب ألّا يزيد عدد الأحرف عن 4096 حرفًا.
createTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لوقت كتابة الإجابة. لا يتم استرداده إلا أثناء استرجاع ListResponse.

طابع زمني بتنسيق 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".

الطُرق

create

 لإضافة سؤال للموقع الجغرافي المحدّد

delete

 يؤدي هذا الإجراء إلى حذف سؤال محدّد من تأليف المستخدم الحالي.

list

 عرض قائمة الأسئلة المقسّمة إلى صفحات وبعض إجاباتها لموقع محدد.

patch

 لتعديل سؤال محدّد كتبه المستخدم الحالي.