REST Resource: users

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

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

जेएसओएन के काेड में दिखाना 
{
  "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 यूज़र इंटरफ़ेस (यूआई) में लॉग इन किया था.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड का रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

AssignedUserRole

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

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

string

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

enum (UserRole)

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

यूनियन फ़ील्ड entity_id. ज़रूरी है.

उस इकाई का आईडी जिस पर उपयोगकर्ता की भूमिका असाइन की गई है. entity_id इनमें से सिर्फ़ एक हो सकती है:
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

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