Method: customers.userLists.list

Belirtilen Ads Data Hub müşterisi tarafından yönetilen kullanıcı listelerini listeler.

HTTP isteği

GET https://adsdatahub.googleapis.com/v1/{parent=customers/*}/userLists

URL, gTB Kod Geçişi söz dizimini kullanır.

Yol parametreleri

Parametreler
parent

string

Zorunlu. Ana müşteri kaynak adı, ör. 'customers/123'.

Sorgu parametreleri

Parametreler
pageSize

integer

Döndürülecek maksimum öğe sayısı. 0 ise sunucu, döndürülecek kullanıcı listelerinin sayısını belirler.
pageToken

string

Önceki bir çağrının döndürdüğü ve sonraki sonuç sayfasını istemek için kullanılan sayfa jetonu.
filter

string

Örnek filtre: title = "user*" AND title = "*name*" AND -type = FREQUENCY_BASED AND createEmail = "creator@email.com" AND listSize > 10 AND filledTime > "2010-04-24t
view

enum (UserListView)

Her bir kullanıcı listesine hangi alanların ekleneceğini belirtir.
showDeleted

boolean

Doğru değerine ayarlanırsa, silinen kullanıcı listeleri yanıta dahil edilir.

İstek metni

İstek metni boş olmalıdır.

Yanıt gövdesi

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

UserLists.list isteğine verilen yanıt. Belirtilen Ads Data Hub müşterisi tarafından yönetilen kullanıcı listelerini içerir.

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

object (UserList)

Kullanıcı listeleri listesi.
nextPageToken

string

Sonraki sonuç sayfasını istemek için kullanılabilecek bir jeton. Başka sonuç yoksa bu alan boş bırakılır.

Yetkilendirme Kapsamları

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

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

Kullanıcı Listesi Görünümü

[userLists.list] API'si tarafından döndürülen her kullanıcı listesine hangi alanların ekleneceğini belirten enum.

Sıralamalar
USER_LIST_VIEW_UNSPECIFIED Varsayılan / ayarlanmamış değer. API varsayılan olarak FULL görünümüne geçer.
BASIC [recipientAdsDataLinks] dışındaki alanları dahil edin.
FULL Her şeyi ekleyin.