REST Resource: customers

משאב: לקוח

כשחשבון של לקוח ב-Google רשום אצל מפיץ, המינויים של הלקוח לשירותי Google מנוהלים על ידי המפיץ. לקוח מתואר לפי שם דומיין ראשי וכתובת פיזית.

ייצוג JSON 
{
  "customerId": string,
  "customerDomain": string,
  "postalAddress": {
    object (Address)
  },
  "phoneNumber": string,
  "alternateEmail": string,
  "resourceUiUrl": string,
  "customerDomainVerified": boolean,
  "kind": string,
  "customerType": enum (CustomerType),
  "primaryAdmin": {
    object (PrimaryAdmin)
  }
}
שדות
customerId

string

הנכס הזה תמיד יוחזר בתגובה כמזהה הייחודי ש-Google יצרה. בבקשה, הנכס הזה יכול להיות הדומיין הראשי או המזהה הייחודי שנוצר על ידי Google.
customerDomain

string

מחרוזת שם הדומיין הראשי של הלקוח. כשיוצרים לקוח חדש, צריך להזין את המאפיין customerDomain. אין להוסיף את הקידומת www בדומיין כשמוסיפים לקוח.
postalAddress

object (Address)

פרטי הכתובת של לקוח. כל שדה מוגבל ל-255 תווים.
phoneNumber

string

מספר הטלפון של איש הקשר. צריך להתחיל ב-"+" ולאחר מכן קוד המדינה. יתר המספר יכול להיות מספרים רציפים או לכבד את מוסכמות הפורמט המקומי, אך עליו להיות מספר טלפון אמיתי ולא, לדוגמה, "123". אם שדה זה לא חוקי, המערכת תתעלם ממנו באופן שקט.
alternateEmail

string

בדומה ל- "כתובת האימייל של הלקוח&" בכלים של המפיץ, כתובת האימייל הזו היא איש הקשר המשני המשמש למקרה שמשהו קורה לשירות של הלקוח, כמו בעיית שירות או בעיית אבטחה. הנכס הזה נדרש בעת יצירת לקוח "דומיין" חדש ואסור להשתמש באותו דומיין כמו customerDomain. אין צורך בשדה alternateEmail כדי ליצור לקוח "team".
resourceUiUrl

string

כתובת URL בלוח הבקרה של מסוף Admin של הלקוח. כתובת ה-URL לקריאה בלבד היא שירות של API. המזהה הזה בשימוש אם אפליקציית הלקוח מחייבת את הלקוח להשלים משימה במסוף Admin.
customerDomainVerified

boolean

אם הדומיין הראשי של הלקוח אומת.
kind

string

מזהה את המשאב כלקוח. ערך: reseller#customer
customerType

enum (CustomerType)

מזהה את סוג הלקוח. הערכים הקבילים כוללים:

  • domain: לרמוז על לקוח שאומת בדומיין (ברירת מחדל).
  • team: לרמוז על לקוח שאומת באימייל.

מידע נוסף זמין במאמר צוותים מנוהלים.
primaryAdmin

object (PrimaryAdmin)

פרטי האדמין הראשונים של הלקוח, בשביל הלקוח של TEAM.

כתובת

תבנית JSON לכתובת של לקוח.

ייצוג JSON 
{
  "countryCode": string,
  "kind": string,
  "region": string,
  "addressLine2": string,
  "locality": string,
  "addressLine3": string,
  "postalCode": string,
  "addressLine1": string,
  "organizationName": string,
  "contactName": string
}
שדות
countryCode

string

למידע על countryCode, יש לעיין ברכיבי קוד המדינה לפי תקן ISO 3166. מוודאים שהמדינה אושרה להפצה של מוצרי Google. הנכס הזה נדרש בעת יצירת לקוח חדש.
kind

string

מזהה את המשאב ככתובת לקוח. ערך: customers#address
region

string

דוגמה לערך של region הוא CA למדינת קליפורניה.
addressLine2

string

שורה 2 של הכתובת.
locality

string

דוגמה לערך locality: העיר San Francisco.
addressLine3

string

שורה 3 של הכתובת.
postalCode

string

דוגמה לpostalCode היא מיקוד כמו 94043. הנכס הזה נדרש בעת יצירת לקוח חדש.
addressLine1

string

הכתובת הפיזית של הלקוח. כתובת יכולה להיות מורכבת משורה אחת עד שלוש שורות. המאפיינים addressline2 ו-addressLine3 הם אופציונליים.
organizationName

string

שם המחלקה של החברה או החברה. זהו שדה חובה.
contactName

string

שם איש הקשר של הלקוח. זהו שדה חובה.

סוג לקוח

סוג הלקוח

Enums
customerTypeUnspecified סוג הלקוח לא ידוע
domain לקוחות בדומיין או בבעלות הדומיין
team לקוחות ללא דומיין או מאומתים באימייל

אדמין ראשי

תבנית JSON עבור מנהל המערכת הראשי במקרה של לקוחות TEAM

ייצוג JSON 
{
  "primaryEmail": string
}
שדות
primaryEmail

string

כתובת האימייל העסקית של מנהל המערכת הראשי של הלקוח.

הקישור לאימות האימייל נשלח לכתובת האימייל הזו במועד יצירת הלקוח. למנהלי מערכת ראשיים יש גישה למסוף הניהול של הלקוח, כולל היכולת להזמין ולהסיר משתמשים ולנהל את צורכי הניהול של הלקוח.

שיטות

get

 מקבלים חשבון לקוח.

insert

 הזמנת חשבון של לקוח חדש.

patch

 מעדכן את ההגדרות של חשבון לקוח.

update

 מעדכן את ההגדרות של חשבון לקוח.