REST Resource: partners.vendors

משאב: חברה

מפיץ, ספק או לקוח בממשק ה-API של מפיץ ולקוח ללא מגע.

ייצוג JSON
{
  "name": string,
  "companyId": string,
  "companyName": string,
  "ownerEmails": [
    string
  ],
  "adminEmails": [
    string
  ],
  "termsStatus": enum (TermsStatus),
  "skipWelcomeEmail": boolean,
  "languageCode": string,
  "googleWorkspaceAccount": {
    object (GoogleWorkspaceAccount)
  }
}
שדות
name

string

פלט בלבד. שם משאב ה-API של החברה. שם המשאב הוא אחד מהפורמטים הבאים:

  • 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

קלט בלבד. אם המדיניות מוגדרת כ-True, הלקוח לא יקבל הודעת אימייל בכניסה. מומלץ לדלג על הודעת הפתיחה אם המכשיר ייתבע במסגרת שירות DEVICE_PROTECTION נוסף, כי הלקוח יקבל אימיילים נפרדים בזמן תביעת הבעלות על המכשיר. אם הלקוח הזה הוא לא 'אפס מגע', המערכת תתעלם משדה זה.

languageCode

string

קלט בלבד. האזור המועדף של הלקוח שמיוצג כקוד שפה BCP47. השדה הזה מאומת בעת הקלט ובקשות הכוללות קודי שפה שאינם נתמכים יידחו.

googleWorkspaceAccount

object (GoogleWorkspaceAccount)

פלט בלבד. חשבון Google Workspace שמשויך ללקוח הזה. משמש רק לחברות של לקוחות.

שיטות

list

רשימת הספקים של השותף.