Method: users.sections.position

इससे किसी सेक्शन के क्रम में बदलाव होता है. ज़्यादा जानकारी के लिए, Google Chat में सेक्शन बनाना और उन्हें व्यवस्थित करना लेख पढ़ें.

इसके लिए, अनुमति के दायरे के साथ उपयोगकर्ता की पुष्टि करना ज़रूरी है:

  • https://www.googleapis.com/auth/chat.users.sections

एचटीटीपी अनुरोध

POST https://chat.googleapis.com/v1/{name=users/*/sections/*}:position

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. उस सेक्शन का संसाधन नाम जिसे पोज़िशन करना है.

फ़ॉर्मैट: users/{user}/sections/{section}

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{

  "sortOrder": integer,
  "relativePosition": enum (Position)
}
फ़ील्ड
ज़रूरी है. सेक्शन की नई पोज़िशन. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में, ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
sortOrder

integer

ज़रूरी नहीं. सेक्शन की सूची में सेक्शन की पोज़िशन. पोजीशन 0 से ज़्यादा होनी चाहिए. अगर सेक्शन की पोज़िशन, सेक्शन की संख्या से ज़्यादा है, तो सेक्शन को सूची के आखिर में जोड़ दिया जाएगा. इस ऑपरेशन से, सेक्शन को दी गई जगह पर डाला जाता है. साथ ही, उस जगह पर मौजूद ओरिजनल सेक्शन और उसके नीचे मौजूद सेक्शन को अगली जगह पर ले जाया जाता है.
relativePosition

enum (Position)

ज़रूरी नहीं. सेक्शन की सूची में सेक्शन की रिलेटिव पोज़िशन.
एक-दूसरे से अलग फ़ील्ड के आखिर में.

जवाब का मुख्य भाग

किसी सेक्शन को पोज़िशन करने के लिए जवाब का मैसेज.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "section": {
    object (Section)
  }
}
फ़ील्ड
section

object (Section)

अपडेट किया गया सेक्शन.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/chat.users.sections

ज़्यादा जानकारी के लिए, अनुमति से जुड़ी गाइड देखें.

स्थिति

सेक्शन की पोज़िशन.

Enums
POSITION_UNSPECIFIED जगह की जानकारी नहीं दी गई है.
START सेक्शन की सूची की शुरुआत.
END सेक्शन की सूची खत्म हो गई है.