Method: subscriptions.list

Google Workspace aboneliklerini listeler. Bu yöntemi nasıl kullanacağınızı öğrenmek için Google Workspace aboneliklerini listeleme başlıklı makaleyi inceleyin.

HTTP isteği

GET https://workspaceevents.googleapis.com/v1beta/subscriptions

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

Sorgu parametreleri

Parametreler
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum abonelik sayısı. Hizmet bu değerden daha az değer döndürebilir.

Belirtilmezse veya 0 olarak ayarlanırsa en fazla 50 abonelik döndürülür.

Maksimum değer 100'dür. 100'den büyük bir değer belirtirseniz sistem yalnızca 100 abonelik döndürür.

pageToken

string

İsteğe bağlı. Önceki bir liste abonelikleri çağrısından alınan bir sayfa jetonu. Sonraki sayfayı almak için bu parametreyi sağlayın.

Sayfalara ayırırken filtre değeri, sayfa jetonunu sağlayan çağrıyla eşleşmelidir. Farklı bir değer iletmek, beklenmedik sonuçlara yol açabilir.

filter

string

Zorunlu. Sorgu filtresi.

Abonelikleri etkinlik türüne (event_types) ve hedef kaynağa (target_resource) göre filtreleyebilirsiniz.

Sorgunuzda en az bir etkinlik türü belirtmelisiniz. Birden fazla etkinlik türünü filtrelemek için OR operatörünü kullanın.

Hem etkinlik türüne hem de hedef kaynağa göre filtrelemek için AND operatörünü kullanarak tam kaynak adını belirtin (ör. //chat.googleapis.com/spaces/{space}).

Örneğin, aşağıdaki sorgular geçerlidir:

event_types:"google.workspace.chat.membership.v1.updated" OR
  event_types:"google.workspace.chat.message.v1.created"

event_types:"google.workspace.chat.message.v1.created" AND
  target_resource="//chat.googleapis.com/spaces/{space}"

( event_types:"google.workspace.chat.membership.v1.updated" OR
  event_types:"google.workspace.chat.message.v1.created" ) AND
  target_resource="//chat.googleapis.com/spaces/{space}"

Sunucu, INVALID_ARGUMENT hatası vererek geçersiz sorguları reddeder.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

SubscriptionsService.ListSubscriptions için yanıt mesajı.

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

JSON gösterimi
{
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
Alanlar
subscriptions[]

object (Subscription)

Abonelik listesi.

nextPageToken

string

Sonraki sayfayı almak için pageToken olarak gönderilebilecek bir jeton. Bu alan atlanırsa sonraki sayfa olmaz.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.