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

غير قابل للتغيير. تشير هذه السمة إلى الاسم الفريد للسؤال. المواقع الجغرافية/*/الأسئلة/* سيتم تجاهل هذا الحقل في حال ضبطها أثناء إنشاء السؤال.
author

object (Author)

النتائج فقط. تمثل هذه السمة كاتب السؤال.
upvoteCount

integer

النتائج فقط. عدد التصويتات المؤيِّدة للسؤال
text

string

مطلوبة. تمثّل هذه السمة نص السؤال. يجب أن يحتوي على ثلاث كلمات على الأقل ويجب أن يكون إجمالي طوله أكبر من أو يساوي 10 أحرف. الحد الأقصى للطول هو 4,096 حرفًا.
createTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لوقت كتابة السؤال.

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
updateTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لآخر تعديل على السؤال

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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

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

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
updateTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لوقت إجراء آخر تعديل على الإجابة

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

الطُرق

create

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

delete

 لحذف سؤال محدد كتبه المستخدم الحالي.

list

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

patch

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