REST Resource: users

Kaynak: Kullanıcı

Display & Video 360'taki 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şmez. Kullanıcıyı tanımlamak için kullanılan e-posta adresi.
displayName

string

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

Maksimum 240 bayt boyutunda ve UTF-8 kodlu olmalıdır.
assignedUserRoles[]

object (AssignedUserRole)

Atanan kullanıcı rolleri.

users.create sürümünde gereklidir. Yalnızca users.patch çıkışı. Yalnızca users.bulkEditAssignedUserRoles üzerinden güncellenebilir.
lastLoginTime

string (Timestamp format)

Yalnızca çıkış. Kullanıcının DV360 kullanıcı arayüzünde en son oturum açtığı zamanın zaman damgası.

Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki saat 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

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

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

  // Union field entity_id can be only one of the following:
  "partnerId": string,
  "advertiserId": string
  // End of list of possible types for union field entity_id.
}
Alanlar
assignedUserRoleId

string

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

enum (UserRole)

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

Birleştirme alanı entity_id. Zorunlu.

Atanan kullanıcı rolünün geçerli olduğu öğenin kimliği. entity_id yalnızca aşağıdakilerden biri olabilir:
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.

UserRole

Olası kullanıcı rolleri.

Sıralamalar
USER_ROLE_UNSPECIFIED Kullanıcı rolü bu sürümde belirtilmediğinde veya bilinmediğinde varsayılan değer.
ADMIN Kullanıcı, kuruluşun kampanyalarını, reklam öğelerini, kampanya siparişlerini, satır öğelerini ve raporlarını yönetebilir. Fatura bilgilerini görüntüleyip düzenleyebilir, kullanıcı oluşturup değiştirebilir ve exchange'leri etkinleştirip devre dışı bırakabilirler. Bu rol yalnızca bir iş ortağı tüzel kişiliği için atanabilir.
ADMIN_PARTNER_CLIENT Kullanıcı, kuruluşun kampanyalarını, reklam öğelerini, kampanya siparişlerini, satır öğelerini ve raporlarını 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, artışları veya bayiye özel diğer alanları görüntüleyemezler. Bu rol yalnızca bir iş ortağı tüzel kişiliği için atanabilir.
STANDARD Kullanıcı, kuruluşun kampanyalarını, reklam öğelerini, kampanya siparişlerini, satır öğelerini ve raporlarını yönetebilir. Kullanıcı oluşturamaz, kullanıcıları değiştiremez veya fatura bilgilerini görüntüleyemezler.
STANDARD_PLANNER Kullanıcı, tüm maliyet verileri dahil olmak üzere kuruluşun 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ı, tüzel kişiliğe ait 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ı, kuruluşun kampanyalarını, reklam öğelerini, kampanya siparişlerini, satır öğelerini ve raporlarını yönetebilir. Diğer kullanıcıları oluşturamaz veya değiştiremez ya da fatura bilgilerini görüntüleyemezler. Gelir modellerini, artışları veya bayiye özel diğer alanları görüntüleyemezler. Bu rol yalnızca bir reklamveren tüzel kişiliği için atanabilir.
READ_ONLY Kullanıcı yalnızca rapor oluşturabilir ve tüzel kişiliğe ait verileri görüntüleyebilir.
REPORTING_ONLY Kullanıcı yalnızca rapor oluşturup yönetebilir.
LIMITED_REPORTING_ONLY Kullanıcı yalnızca şu müşteri için uygun 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, diğer reklam öğesi yöneticilerini veya reklam öğesi kullanıcılarını da tüzel kişiliğe 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

 Geçerli kullanıcının erişebildiği kullanıcıları listeler.

patch

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