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, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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

טיפוסים בני מנייה (ennum) לסוג המשתמש שאותו הוא מחבר.

טיפוסים בני מנייה (enums)
AUTHOR_TYPE_UNSPECIFIED לא מומלץ להשתמש בו.
REGULAR_USER משתמש רגיל.
LOCAL_GUIDE ממליץ מקומי
MERCHANT הבעלים/המנהל של המיקום

תשובה

ייצוג של תשובה לשאלה

ייצוג JSON 
{
  "name": string,
  "author": {
    object (Author)
  },
  "upvoteCount": integer,
  "text": string,
  "createTime": string,
  "updateTime": string
}
שדות
name

string

פלט בלבד. השם הייחודי של מיקומי התשובה/*/שאלות/*/answers/*
author

object (Author)

פלט בלבד. מחבר התשובה. יוגדר רק במהלך פעולות ברשימה.
upvoteCount

integer

פלט בלבד. מספר ההצבעות בעד התשובה.
text

string

חובה. טקסט התשובה. הוא צריך להכיל לפחות תו אחד שהוא לא רווח לבן. האורך המקסימלי הוא 4,096 תווים.
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".

שיטות

create

 הוספת שאלה למיקום שצוין.

delete

 מחיקת שאלה ספציפית שכתב המשתמש הנוכחי.

list

 מחזירה רשימה מעומדת של שאלות ואת חלק מהתשובות שלה למיקום שצוין.

patch

 עדכון שאלה ספציפית שנכתבה על ידי המשתמש הנוכחי.