REST Resource: users

Kaynak: Kullanıcı

Display & Video 360'ta tek bir kullanıcı.

JSON gösterimi
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ],
  "lastLoginTime": string
}
Alanlar
name

string

Yalnızca çıkış. Kullanıcının kaynak adı.

userId

string (int64 format)

Yalnızca çıkış. Kullanıcının benzersiz kimliği. Sistem tarafından atanır.

email

string

Zorunlu. Değiştirilemez. Kullanıcıyı tanımlamak için kullanılan e-posta adresi.

displayName

string

Zorunlu. Kullanıcının görünen adı.

UTF-8 olarak kodlanmış ve maksimum 240 bayt boyutunda olmalıdır.

assignedUserRoles[]

object (AssignedUserRole)

Atanan kullanıcı rolleri.

users.create bölgesinde zorunludur. Yalnızca users.patch dilinde yanıt verin. Yalnızca users.bulkEditAssignedUserRoles üzerinden güncellenebilir.

lastLoginTime

string (Timestamp format)

Yalnızca çıkış. Kullanıcının DV360 kullanıcı arayüzüne en son giriş yaptığı zaman damgası.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

AssignedUserRole

Kullanıcının belirli bir iş ortağı veya reklamverenle yetkili etkileşimini tanımlayan tek bir atanmış kullanıcı rolü.

JSON gösterimi
{
  "assignedUserRoleId": string,
  "userRole": enum (UserRole),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "partnerId": string,
  "advertiserId": string
  // End of mutually exclusive fields.
}
Alanlar
assignedUserRoleId

string

Yalnızca çıkış. Atanan kullanıcı rolünün kimliği.

userRole

enum (UserRole)

Zorunlu. Varlık için kullanıcıya atanacak kullanıcı rolü.

Zorunlu.

Atanan kullanıcı rolünün geçerli olduğu varlığın kimliği. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır:

partnerId

string (int64 format)

Atanan kullanıcı rolünün geçerli olduğu iş ortağının kimliği.

advertiserId

string (int64 format)

Atanan kullanıcı rolünün geçerli olduğu reklamverenin kimliği.

Birbirini hariç tutan alanların sonu.

UserRole

Olası kullanıcı rolleri.

Sıralamalar
USER_ROLE_UNSPECIFIED Kullanıcı rolü belirtilmediğinde veya bu sürümde bilinmediğinde kullanılan varsayılan değer.
ADMIN Kullanıcı, varlık için kampanyaları, reklam öğelerini, kampanya siparişlerini, satır öğelerini ve raporları yönetebilir. Fatura bilgilerini görüntüleyip düzenleyebilir, kullanıcı oluşturabilir veya değiştirebilir ve exchange'leri etkinleştirebilir ya da devre dışı bırakabilirler. Bu rol yalnızca bir iş ortağı tüzel kişisi için atanabilir.
ADMIN_PARTNER_CLIENT Kullanıcı, varlık için kampanyaları, reklam öğelerini, kampanya siparişlerini, satır öğelerini ve raporları yönetebilir. Diğer ADMIN_PARTNER_CLIENT kullanıcılarını oluşturup değiştirebilir ve fatura bilgilerini görüntüleyebilirler. Gelir modellerini, fiyat artışlarını veya bayilerle ilgili diğer hassas alanları görüntüleyemezler. Bu rol yalnızca bir iş ortağı tüzel kişisi için atanabilir.
STANDARD Kullanıcı, varlık için kampanyaları, reklam öğelerini, kampanya siparişlerini, satır öğelerini ve raporları yönetebilir. Kullanıcı oluşturamaz, değiştiremez veya fatura bilgilerini görüntüleyemezler.
STANDARD_PLANNER Kullanıcı, tüm maliyet verileri dahil olmak üzere varlığın tüm kampanyalarını, reklam öğelerini, kampanya siparişlerini, satır öğelerini ve raporlarını görüntüleyebilir. Planlar ve envanter dahil olmak üzere planlamayla ilgili özellikler oluşturabilir veya bunları değiştirebilirler.
STANDARD_PLANNER_LIMITED Kullanıcı, varlıkla ilgili tüm kampanyaları, reklam öğelerini, kampanya siparişlerini, satır öğelerini ve raporları görüntüleyebilir. Planlar ve envanter dahil olmak üzere planlamayla ilgili özellikler oluşturabilir veya bunları değiştirebilirler. Maliyet verilerine erişemezler ve anlaşma başlatamaz, kabul edemez veya anlaşmalar için pazarlık yapamazlar.
STANDARD_PARTNER_CLIENT Kullanıcı, varlık için kampanyaları, reklam öğelerini, kampanya siparişlerini, satır öğelerini ve raporları yönetebilir. Başka kullanıcılar oluşturamaz veya değiştiremez ya da fatura bilgilerini görüntüleyemezler. Gelir modellerini, fiyat artışlarını veya bayilerle ilgili diğer hassas alanları görüntüleyemezler. Bu rol yalnızca bir reklamveren varlığı için atanabilir.
READ_ONLY Kullanıcı yalnızca öğe için rapor oluşturabilir ve verileri görüntüleyebilir.
REPORTING_ONLY Kullanıcı yalnızca rapor oluşturabilir ve yönetebilir.
LIMITED_REPORTING_ONLY Kullanıcı yalnızca müşteri için uygun olan şu raporları oluşturup yönetebilir: Genel, Kitle Performansı, İş Ortakları Arası, Anahtar Kelime, Sipariş Kimliği, Kategori ve Üçüncü Taraf Veri Sağlayıcısı.
CREATIVE Kullanıcı, ortak çalışma için ihtiyaç duyduğu medya planı bilgilerini görüntüleyebilir ancak maliyetle ilgili verileri veya pazar yerini görüntüleyemez.
CREATIVE_ADMIN Kullanıcı, ortak çalışma için ihtiyaç duyduğu medya planı bilgilerini görüntüleyebilir ancak maliyetle ilgili verileri veya pazar yerini görüntüleyemez. Ayrıca, öğeye başka reklam öğesi yöneticileri veya reklam öğesi kullanıcıları ekleyebilirler.

Yöntemler

bulkEditAssignedUserRoles

Bir kullanıcının kullanıcı rollerini toplu olarak düzenler.

create

Yeni bir kullanıcı oluşturur.

delete

Bir kullanıcıyı siler.

get

Bir kullanıcıyı alır.

list

Mevcut kullanıcının erişebileceği kullanıcıları listeler.

patch

Mevcut bir kullanıcıyı günceller.