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

בלתי ניתן לשינוי. השם הייחודי של השאלה. locations/*/questions/* , המערכת תתעלם מהשדה הזה אם הוא יוגדר במהלך יצירת השאלה.
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

דוגמאות לסוג המשתמש של המחבר.

טיפוסים בני מנייה (enum)
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

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