Method: users.sections.position

Bir bölümün sıralama ölçütünü değiştirir. Ayrıntılı bilgi için Google Chat'te bölüm oluşturma ve düzenleme başlıklı makaleyi inceleyin.

Yetkilendirme kapsamı ile kullanıcı kimlik doğrulaması gerektirir:

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

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Zorunlu. Konumlandırılacak bölümün kaynak adı.

Biçim: users/{user}/sections/{section}

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{

  // Union field position can be only one of the following:
  "sortOrder": integer,
  "relativePosition": enum (Position)
  // End of list of possible types for union field position.
}
Alanlar
position birleşik alanı. Zorunlu. Bölümün yeni konumu. position aşağıdakilerden yalnızca biri olabilir:
sortOrder

integer

İsteğe bağlıdır. Bölümün, bölümler listesindeki mutlak konumu. Pozisyon 0'dan büyük olmalıdır. Konum, bölüm sayısından büyükse bölüm listenin sonuna eklenir. Bu işlem, bölümü belirtilen konuma ekler ve o konumdaki orijinal bölümü ve altındaki bölümleri bir sonraki konuma kaydırır.
relativePosition

enum (Position)

İsteğe bağlıdır. Bölümün, bölümler listesindeki göreli konumu.

Yanıt metni

Bir bölümü konumlandırma için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "section": {
    object (Section)
  }
}
Alanlar
section

object (Section)

Güncellenen bölüm.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

Konum

Bölümün konumu.

Sıralamalar
POSITION_UNSPECIFIED Belirtilmemiş konum.
START Bölüm listesinin başlangıcı.
END Bölüm listesinin sonu.