Method: sellers.adUnits.list

Reklam birimlerini listeler.

  • Örneğin GET /v1/sellers/seller111/adUnits
  • Reklam birimlerinin listesini ve başarılı olursa sonraki sayfayı almak için bir jeton döndürür.
  • Kullanıcının satıcıya erişimi yoksa veya satıcı kimliği yoksa PERMISSION_DENIED hata kodunu döndürür.
  • Satıcılar geçersiz sayfa boyutu veya sayfa jetonu sağlarsa INVALID_ARGUMENT hata kodunu döndürür.

HTTP isteği

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adUnits

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

Yol parametreleri

Parametreler
parent

string

Zorunlu. Bu reklam birimi koleksiyonuna sahip olan satıcı. Biçim: sellers/{seller}

Sorgu parametreleri

Parametreler
pageSize

integer

Döndürülecek maksimum öğe sayısı. Hizmet bu değerden daha az bir değer döndürebilir. İzin verilen maksimum reklam birimi sayısı 1.000'dir; 1000'in üzerindeki değerler 1000 olarak değiştirilecek. Belirtilmemişse en fazla 1.000 reklam birimi döndürülür.
pageToken

string

Varsa önceki Liste isteğinden döndürülen nextPageToken değeri.
filter

string

Liste filtresi. Şu anda şu söz dizimiyle harici kimlik ve durum filtrelemeyi destekler: "externalId = [EXTERNAL_ID]" ve "eyalet = [DURUM]". AND ve OR mantıksal operatörleri, zincir filtreleri uygulamak için kullanılabilir. AD_UNIT_STATE_DELETED, silinen reklam birimlerini göstermek için kullanılamaz. Bunun yerine show deleted değerini kullanın.
orderBy

string

Sonuçların sıralama düzenini belirtmek için kullanılan dizeye göre sıralama. Şu anda updateTime bazında sipariş vermeyi desteklemektedir. "updateTime" sağlayın sonuçları artan düzende "updateTime"a veya "updateTime az"a göre sıralayabilirsiniz kullanın.
showDeleted

boolean

Geri yüklenebilir şekilde silinen reklam birimlerinin döndürülüp döndürülmeyeceğini belirler.

İstek içeriği

İ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:

InventoryService.ListAdUnits için yanıt mesajı.

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

object (AdUnit)

Reklam birimlerinin listesi.
nextPageToken

string

Sonuçların sonraki sayfasını almak için jeton. Sonraki sonuç sayfasını almak için bu değeri, adUnits.list yöntemine yapılan bir sonraki çağrıda pageToken alanına iletin.

Yetkilendirme Kapsamları

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

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.