REST Resource: partners.customers

संसाधन: कंपनी

'पहले से तैयार डिवाइस' सुविधा वाले रीसेलर और कस्टमर एपीआई में रीसेलर, वेंडर या ग्राहक.

JSON के काेड में दिखाना
{
  "name": string,
  "companyId": string,
  "companyName": string,
  "ownerEmails": [
    string
  ],
  "adminEmails": [
    string
  ],
  "termsStatus": enum (TermsStatus),
  "skipWelcomeEmail": boolean,
  "languageCode": string,
  "googleWorkspaceAccount": {
    object (GoogleWorkspaceAccount)
  }
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. कंपनी के एपीआई रिसॉर्स का नाम. संसाधन का नाम नीचे दिए गए फ़ॉर्मैट में से एक है:

  • partners/[PARTNER_ID]/customers/[CUSTOMER_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]
  • partners/[PARTNER_ID]/vendors/[VENDOR_ID]/customers/[CUSTOMER_ID]

सर्वर की ओर से असाइन किया गया.

companyId

string (int64 format)

सिर्फ़ आउटपुट के लिए. कंपनी का आईडी. सर्वर की ओर से असाइन किया गया.

companyName

string

ज़रूरी है. कंपनी का नाम. उदाहरण के लिए, XYZ Corp. 'पहले से तैयार डिवाइस' सुविधा वाले पोर्टल पर कंपनी के कर्मचारियों को दिखाया जाता है.

ownerEmails[]

string

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

adminEmails[]

string

ज़रूरी नहीं. एडमिन की भूमिका वाले ग्राहक के उपयोगकर्ताओं का ईमेल पता. हर ईमेल पता किसी Google खाते से जुड़ा होना चाहिए.

termsStatus

enum (TermsStatus)

सिर्फ़ आउटपुट के लिए. कंपनी के किसी उपयोगकर्ता ने सेवा की नई शर्तें स्वीकार की हैं या नहीं. TermsStatus देखें.

skipWelcomeEmail

boolean

सिर्फ़ इनपुट. अगर नीति को 'सही है' पर सेट किया जाता है, तो ग्राहक को वेलकम ईमेल नहीं भेजा जाएगा. अगर डिवाइसों पर डिवाइस पर दावा करने के लिए, डिवाइस पर अतिरिक्तDEVICE_PROTECTION सेवा का इस्तेमाल किया जाएगा, तो स्वागत ईमेल को स्किप कर देने का सुझाव दिया जाता है. ऐसा इसलिए, क्योंकि डिवाइस पर दावा करने के समय ग्राहक को अलग से ईमेल मिलेंगे. अगर 'पहले से तैयार डिवाइस' सुविधा वाले ग्राहक नहीं हैं, तो इस फ़ील्ड को अनदेखा किया जाता है.

languageCode

string

सिर्फ़ इनपुट. ग्राहक की पसंदीदा स्थान-भाषा, जिसे BCP47 भाषा कोड के तौर पर दिखाया गया है. इनपुट पर इस फ़ील्ड की पुष्टि की गई है. साथ ही, जिन अनुरोधों में काम न करने वाले भाषा कोड शामिल हैं उन्हें अस्वीकार कर दिया जाएगा. सभी भाषाओं के कोड: (

googleWorkspaceAccount

object (GoogleWorkspaceAccount)

सिर्फ़ आउटपुट के लिए. इस ग्राहक से जुड़ा Google Workspace खाता. इसका इस्तेमाल सिर्फ़ ग्राहक कंपनियों के लिए किया जाता है.

TermsStatus

ज़ीरो-टच रजिस्ट्रेशन की सुविधा से जुड़ी सेवा की शर्तों (सेवा की शर्तों) को स्वीकार करना. कोई एक उपयोगकर्ता, वेब पोर्टल का इस्तेमाल करके अपनी कंपनी के लिए सेवा की शर्तों को स्वीकार कर सकता है.

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

Enums
TERMS_STATUS_NOT_ACCEPTED कंपनी के किसी भी उपयोगकर्ता ने सेवा की शर्तों को स्वीकार नहीं किया है.
TERMS_STATUS_ACCEPTED कंपनी के एक या उससे ज़्यादा उपयोगकर्ताओं ने सेवा की शर्तों को स्वीकार कर लिया है.
TERMS_STATUS_STALE कंपनी के किसी भी उपयोगकर्ता ने सेवा की मौजूदा शर्तों को स्वीकार नहीं किया है. हालांकि, कम से कम एक उपयोगकर्ता ने सेवा की पिछली शर्तों को स्वीकार किया है.

GoogleWorkspaceAccount

Google Workspace ग्राहक हैं.

JSON के काेड में दिखाना
{
  "customerId": string,
  "preProvisioningTokens": [
    string
  ]
}
फ़ील्ड
customerId

string

ज़रूरी है. ग्राहक आईडी.

preProvisioningTokens[]

string

सिर्फ़ आउटपुट के लिए. डिवाइसों पर दावा करने के लिए, पहले से इस्तेमाल किए जाने वाले प्री-प्रॉविज़न टोकन.

तरीके

create

ज़ीरो-टच रजिस्ट्रेशन के लिए ग्राहक बनाता है.

list

यह उन ग्राहकों की सूची बनाता है जिन्होंने partnerId आर्ग्युमेंट में, रीसेलर के साथ रजिस्टर किया गया है.