Method: mediaPlanners.list

Arayanın erişebildiği tüm medya planlayıcı hesaplarını listeler.

Küratörler için bu, küratör şartlarını kabul eden tüm medya planlayıcıları döndürür.

Diğer hesaplarda medya planlayıcıları listelemeye çalışmak hata döndürür.

HTTP isteği

GET https://curationpartners.googleapis.com/v1/mediaPlanners

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

Sorgu parametreleri

Parametreler
pageSize

integer

Döndürülecek maksimum medya planlayıcı sayısı. Belirtilmezse en fazla 100 medya planlayıcı döndürülür. Maksimum değer 500'dür. 500'den yüksek değerler 500'e zorlanır.
pageToken

string

İsteğe bağlı. Sunucunun döndürmesi gereken sonuç sayfasını tanımlayan jeton.Bu değer, ListMediaPlannersResponse.nextPageToken içindeki önceki bir mediaPlanners.list çağrısından alınır.
filter

string

Cloud API liste filtreleme söz dizimi kullanılarak oluşturulan isteğe bağlı sorgu dizesi. Filtreleme için desteklenen sütunlar şunlardır:

  • name
  • displayName
  • ancestorNames

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Medya planlayıcı hesabı bilgilerini içeren bir yanıt.

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

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

object (MediaPlanner)

Medya planlayıcılarının listesi.
nextPageToken

string

ListMediaPlannersRequest.page_token içindeki sonuçların sonraki sayfasını almak için mediaPlanners.list yöntemine yapılan sonraki bir çağrıya iletilebilen jeton.

Yetkilendirme kapsamları

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

  • https://www.googleapis.com/auth/curation-partners

MediaPlanner

Medya planlayıcı hesabını temsil eder.

JSON gösterimi 
{
  "accountId": string,
  "name": string,
  "displayName": string,
  "ancestorNames": [
    string
  ]
}
Alanlar
accountId
(deprecated)

string

Yalnızca çıkış. Medya planlayıcının hesap kimliği.
name

string

Tanımlayıcı. Medya planlayıcının benzersiz kaynak adı. Biçim: mediaPlanners/{mediaPlannerAccountId}. mediaPlanners.list yönteminin yanıtını filtrelemek için kullanılabilir.
displayName

string

Yalnızca çıkış. Medya planlayıcının görünen adı. [mediaPlanners.list][google.ads.authorizedbuyers.marketplace.v1main.MediaPlanners.ListMediaPlanners] yönteminin yanıtını filtrelemek için kullanılabilir.
ancestorNames[]

string

Yalnızca çıkış. Medya planlayıcının üst öğe adları. Biçim: mediaPlanners/{mediaPlannerAccountId}. mediaPlanners.list yönteminin yanıtını filtrelemek için kullanılabilir.