REST Resource: users

संसाधन: उपयोगकर्ता

Display & Video 360 में एक उपयोगकर्ता.

JSON के काेड में दिखाना 
{
  "name": string,
  "userId": string,
  "email": string,
  "displayName": string,
  "assignedUserRoles": [
    {
      object (AssignedUserRole)
    }
  ],
  "lastLoginTime": string
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. उपयोगकर्ता के संसाधन का नाम.
userId

string (int64 format)

सिर्फ़ आउटपुट के लिए. उपयोगकर्ता का यूनीक आईडी. सिस्टम की ओर से असाइन किया जाता है.
email

string

ज़रूरी है. इम्यूटेबल. इस ईमेल पते का इस्तेमाल, उपयोगकर्ता की पहचान करने के लिए किया जाता है.
displayName

string

ज़रूरी है. उपयोगकर्ता का डिसप्ले नेम.

इसे UTF-8 में एन्कोड किया जाना चाहिए. इसका साइज़ ज़्यादा से ज़्यादा 240 बाइट होना चाहिए.
assignedUserRoles[]

object (AssignedUserRole)

उपयोगकर्ता को असाइन की गई भूमिकाएं.

users.create में ज़रूरी है. जवाब सिर्फ़ users.patch में दें. इसे सिर्फ़ users.bulkEditAssignedUserRoles के ज़रिए अपडेट किया जा सकता है.
lastLoginTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. वह टाइमस्टैंप जब उपयोगकर्ता ने DV360 के यूज़र इंटरफ़ेस (यूआई) में आखिरी बार लॉग इन किया था.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

AssignedUserRole

उपयोगकर्ता को असाइन की गई एक भूमिका, जो किसी पार्टनर या विज्ञापन देने वाले व्यक्ति या कंपनी के साथ उपयोगकर्ता के मान्य इंटरैक्शन को तय करती है.

JSON के काेड में दिखाना 
{
  "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.
}
फ़ील्ड
assignedUserRoleId

string

सिर्फ़ आउटपुट के लिए. असाइन की गई उपयोगकर्ता की भूमिका का आईडी.
userRole

enum (UserRole)

ज़रूरी है. उपयोगकर्ता को इकाई के लिए असाइन की जाने वाली भूमिका.

ज़रूरी है.

उस इकाई का आईडी जिस पर उपयोगकर्ता को असाइन की गई भूमिका लागू होती है. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
partnerId

string (int64 format)

उस पार्टनर का आईडी जिस पर असाइन की गई उपयोगकर्ता भूमिका लागू होती है.
advertiserId

string (int64 format)

विज्ञापन देने वाले उस व्यक्ति या कंपनी का आईडी जिस पर उपयोगकर्ता की असाइन की गई भूमिका लागू होती है.
एक-दूसरे से अलग फ़ील्ड के आखिर में.

UserRole

उपयोगकर्ता की भूमिकाएं.

Enums
USER_ROLE_UNSPECIFIED जब इस वर्शन में उपयोगकर्ता की भूमिका के बारे में नहीं बताया गया है या इसकी जानकारी नहीं है, तब डिफ़ॉल्ट वैल्यू.
ADMIN उपयोगकर्ता, इकाई के लिए कैंपेन, क्रिएटिव, इंसर्शन ऑर्डर, लाइन आइटम, और रिपोर्ट मैनेज कर सकता है. वे बिलिंग की जानकारी देख सकते हैं और उसमें बदलाव कर सकते हैं. साथ ही, उपयोगकर्ताओं को बना सकते हैं या उनमें बदलाव कर सकते हैं. इसके अलावा, वे एक्सचेंज को चालू या बंद कर सकते हैं. यह भूमिका सिर्फ़ पार्टनर इकाई के लिए असाइन की जा सकती है.
ADMIN_PARTNER_CLIENT उपयोगकर्ता, इकाई के लिए कैंपेन, क्रिएटिव, इंसर्शन ऑर्डर, लाइन आइटम, और रिपोर्ट मैनेज कर सकता है. वे अन्य ADMIN_PARTNER_CLIENT उपयोगकर्ताओं को बना सकते हैं और उनमें बदलाव कर सकते हैं. साथ ही, बिलिंग की जानकारी देख सकते हैं. वे रेवेन्यू मॉडल, मार्कअप या रीसेलर के लिए ज़रूरी कोई अन्य फ़ील्ड नहीं देख सकते. यह भूमिका सिर्फ़ पार्टनर इकाई के लिए असाइन की जा सकती है.
STANDARD उपयोगकर्ता, इकाई के लिए कैंपेन, क्रिएटिव, इंसर्शन ऑर्डर, लाइन आइटम, और रिपोर्ट मैनेज कर सकता है. वे उपयोगकर्ताओं को न तो बना सकते हैं और न ही उनमें बदलाव कर सकते हैं. साथ ही, वे बिलिंग की जानकारी भी नहीं देख सकते.
STANDARD_PLANNER उपयोगकर्ता, इकाई के लिए सभी कैंपेन, क्रिएटिव, इंसर्शन ऑर्डर, लाइन आइटम, और रिपोर्ट देख सकता है. इसमें लागत डेटा भी शामिल है. ये लोग, प्लान बनाने और उनमें बदलाव करने के साथ-साथ इन्वेंट्री जैसी प्लानिंग से जुड़ी सुविधाएं भी बना सकते हैं.
STANDARD_PLANNER_LIMITED उपयोगकर्ता, इकाई के लिए सभी कैंपेन, क्रिएटिव, इंसर्शन ऑर्डर, लाइन आइटम, और रिपोर्ट देख सकता है. ये लोग, प्लान और इन्वेंट्री जैसी प्लानिंग से जुड़ी सुविधाएं बना सकते हैं या उनमें बदलाव कर सकते हैं. उनके पास लागत डेटा का ऐक्सेस नहीं होता. साथ ही, वे डील शुरू नहीं कर सकते, उन्हें स्वीकार नहीं कर सकते या उन पर बातचीत नहीं कर सकते.
STANDARD_PARTNER_CLIENT उपयोगकर्ता, इकाई के लिए कैंपेन, क्रिएटिव, इंसर्शन ऑर्डर, लाइन आइटम, और रिपोर्ट मैनेज कर सकता है. वे न तो अन्य उपयोगकर्ताओं को बना सकते हैं और न ही उनमें बदलाव कर सकते हैं. साथ ही, वे बिलिंग की जानकारी भी नहीं देख सकते. वे रेवेन्यू मॉडल, मार्कअप या रीसेलर के लिए ज़रूरी कोई अन्य फ़ील्ड नहीं देख सकते. यह भूमिका सिर्फ़ विज्ञापन देने वाले व्यक्ति या कंपनी को असाइन की जा सकती है.
READ_ONLY उपयोगकर्ता सिर्फ़ रिपोर्ट बना सकता है और इकाई के लिए डेटा देख सकता है.
REPORTING_ONLY उपयोगकर्ता सिर्फ़ रिपोर्ट बना सकता है और उन्हें मैनेज कर सकता है.
LIMITED_REPORTING_ONLY उपयोगकर्ता सिर्फ़ इन क्लाइंट के लिए सुरक्षित रिपोर्ट बना सकता है और उन्हें मैनेज कर सकता है: सामान्य, ऑडियंस की परफ़ॉर्मेंस, क्रॉस-पार्टनर, कीवर्ड, ऑर्डर आईडी, कैटगरी, और तीसरे पक्ष का डेटा उपलब्ध कराने वाली कंपनी.
CREATIVE उपयोगकर्ता को मीडिया प्लान की वह जानकारी दिखती है जिसकी मदद से वह साथ मिलकर काम कर सकता है. हालांकि, उसे लागत से जुड़ा डेटा या Marketplace नहीं दिखता.
CREATIVE_ADMIN उपयोगकर्ता को मीडिया प्लान की वह जानकारी दिखती है जिसकी मदद से वह साथ मिलकर काम कर सकता है. हालांकि, उसे लागत से जुड़ा डेटा या Marketplace नहीं दिखता. इसके अलावा, वे इकाई में अन्य क्रिएटिव एडमिन या क्रिएटिव उपयोगकर्ताओं को जोड़ सकते हैं.

तरीके

bulkEditAssignedUserRoles

 यह कुकी, किसी उपयोगकर्ता की भूमिकाओं में एक साथ कई बदलाव करती है.

create

 यह कुकी, नया उपयोगकर्ता बनाती है.

delete

 यह कुकी, किसी उपयोगकर्ता को मिटाती है.

get

 यह कुकी, किसी उपयोगकर्ता को मिलती है.

list

 उन उपयोगकर्ताओं की सूची दिखाता है जिन्हें मौजूदा उपयोगकर्ता ऐक्सेस कर सकता है.

patch

 किसी मौजूदा उपयोगकर्ता की जानकारी अपडेट करता है.