Method: accountTypes.accounts.userLists.list

UserLists'i listeler.

Yetkilendirme üstbilgileri:

Bu yöntem, API'nin istek için erişimi nasıl yetkilendireceğini tanımlamak üzere aşağıdaki isteğe bağlı üstbilgileri destekler:

  • login-account: (İsteğe bağlı) Kimlik bilgilerinin Google Hesabı'nın kullanıcı olduğu hesabın kaynak adı. Ayarlanmamışsa varsayılan olarak isteğin hesabına ayarlanır. Biçim: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (İsteğe bağlı) login-account ile oluşturulmuş bir ürün bağlantısı olan hesabın kaynak adı. Biçim: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}

HTTP isteği

GET https://datamanager.googleapis.com/v1/{parent=accountTypes/*/accounts/*}/userLists

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

Yol parametreleri

Parametreler
parent

string

Zorunlu. Bu kullanıcı listeleri koleksiyonunun sahibi olan üst hesap. Biçim: accountTypes/{accountType}/accounts/{account}

Sorgu parametreleri

Parametreler
pageSize

integer

İsteğe bağlı. Döndürülecek maksimum kullanıcı listesi sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmezse en fazla 50 kullanıcı listesi döndürülür. Maksimum değer 1.000'dir. 1.000'in üzerindeki değerler 1.000'e zorlanır.

pageToken

string

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

Sayfalara ayırma işlemi yapılırken userLists.list öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

filter

string

İsteğe bağlı. Filtre dizesi. Tüm alanlar her koşulun sol tarafında olmalıdır (örneğin: display_name = "list 1"). Alanlar, tümü camel case veya tümü snake case kullanılarak belirtilmelidir. Camel case ve snake case kombinasyonu kullanmayın.

Desteklenen işlemler:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=
  • : (var)

Desteklenen işlevler: - IN(field, value1, value2, ...): Alan değerlerinden herhangi biriyle eşleşirse true değerini döndürür. Örnek: IN(display_name, "name1", "name2")

Desteklenen alanlar:

  • id
  • display_name
  • description
  • membership_status
  • integration_code
  • access_reason
  • ingested_user_list_info.upload_key_types

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

userLists.list için yanıt mesajı.

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

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

object (UserList)

Belirtilen hesaptaki kullanıcı listeleri.

nextPageToken

string

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

Yetkilendirme kapsamları

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

  • https://www.googleapis.com/auth/datamanager