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ştirilemez. 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 UTF-8 kodlu olmalıdır.

assignedUserRoles[]

object (AssignedUserRole)

Atanan kullanıcı rolleri.

users.create'da zorunludur. 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ü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

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),

  // 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, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan 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 dışlayan alanların sonu.

UserRole

Olası kullanıcı rolleri.

Sıralamalar
USER_ROLE_UNSPECIFIED Kullanıcı rolü bu sürümde belirtilmediğinde veya bilinmediğinde kullanılan varsayılan değer.
ADMIN Kullanıcı, tüzel kişinin 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şturabilir veya değiştirebilir ve borsa işlemlerini etkinleştirebilir ya da devre dışı bırakabilirler. Bu rol yalnızca bir iş ortağı tüzel kişiliği için atanabilir.
ADMIN_PARTNER_CLIENT Kullanıcı, tüzel kişinin 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, fiyat artışlarını 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ı, tüzel kişinin 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. Ayrıca, 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ı, tüzel kişinin 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ştiremezler ya da fatura bilgilerini görüntüleyemezler. Gelir modellerini, fiyat artışlarını 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 öğeyle ilgili raporlar 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, kuruluşa başka reklam öğesi yöneticileri veya reklam öğesi kullanıcıları da ekleyebilirler.

Yöntemler

bulkEditAssignedUserRoles

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

create

Yeni bir kullanıcı oluşturur.

delete

Kullanıcıyı siler.

get

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.