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

इम्यूटेबल. सवाल का यूनीक नाम. Places/*/questions/* अगर सवाल बनाने के दौरान इस फ़ील्ड को सेट किया जाता है, तो इस फ़ील्ड को अनदेखा कर दिया जाएगा.
author

object (Author)

सिर्फ़ आउटपुट के लिए. सवाल लिखने वाला व्यक्ति.
upvoteCount

integer

सिर्फ़ आउटपुट के लिए. सवाल को कितनी बार पसंद किया गया.
text

string

ज़रूरी है. सवाल का टेक्स्ट. इसमें कम से कम तीन शब्द होने चाहिए और कुल लंबाई 10 वर्णों से ज़्यादा या उसके बराबर होनी चाहिए. ज़्यादा से ज़्यादा 4,096 वर्ण इस्तेमाल किए जा सकते हैं.
createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. सवाल लिखे जाने के समय का टाइमस्टैंप.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. सवाल में पिछली बार कब बदलाव किया गया, इसका टाइमस्टैंप.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "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

उपयोगकर्ता की प्रोफ़ाइल फ़ोटो का यूआरआई.
type

enum (AuthorType)

लेखक किस तरह का उपयोगकर्ता है.

AuthorType

लेखक के उपयोगकर्ता के तौर पर Enum.

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

सिर्फ़ आउटपुट के लिए. जवाब के लिए यूनीक नाम/*/questions/*/answers/*
author

object (Author)

सिर्फ़ आउटपुट के लिए. जवाब लिखने वाला व्यक्ति. सिर्फ़ सूची से जुड़ी कार्रवाइयों के दौरान सेट किया जाएगा.
upvoteCount

integer

सिर्फ़ आउटपुट के लिए. जवाब को पसंद किए जाने की संख्या.
text

string

ज़रूरी है. जवाब का टेक्स्ट. इसमें कम से कम एक वर्ण होना चाहिए. यह वर्ण खाली नहीं होना चाहिए. ज़्यादा से ज़्यादा 4,096 वर्ण इस्तेमाल किए जा सकते हैं.
createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. जवाब लिखे जाने के समय का टाइमस्टैंप. सिर्फ़ ListResponse फ़ेच करने के दौरान मिला.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. जवाब में आखिरी बार बदलाव किए जाने का टाइमस्टैंप.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

तरीके

create

 बताई गई जगह के लिए सवाल जोड़ता है.

delete

 मौजूदा उपयोगकर्ता के लिखे गए किसी सवाल को मिटा देता है.

list

 यह फ़ंक्शन किसी खास जगह के लिए, सवालों की पेजों वाली सूची और उसके कुछ जवाबों को दिखाता है.

patch

 मौजूदा उपयोगकर्ता की ओर से लिखे गए किसी खास सवाल को अपडेट करता है.