כדי לנהל את הלקוחות באופן פרוגרמטי, אפשר להשתמש ב-Directory API. תוכלו להשתמש בשיטות ב-API הזה כדי לעדכן את הפרטים ליצירת קשר בדומיין שלכם ב-G Suite, וגם לשנות את הדומיין הראשי של המכונה שלכם.
אחזור לקוח
כדי לאחזר לקוח קיים, משתמשים בבקשת ה-HTTP הבאה GET
וכוללים את אסימון ההרשאה שמתואר בבקשות הרשאה. הערך customerKey
יכול להיות מזהה הלקוח הייחודי, או my_customer
כדי לציין את הלקוח הנוכחי.
GET https://admin.googleapis.com/admin/directory/v1/customers/customerKey
תגובה מוצלחת מחזירה את קוד הסטטוס HTTP 200. יחד עם קוד הסטטוס, תגובת ה-JSON כוללת את פרטי הלקוח:
{
"etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
"kind": "admin#directory#customer",
"alternateEmail": "marty.mcfly@gmail.com",
"id": "C03xgje4y",
"customerDomain": "amatchmadeinspace.com",
"postalAddress": {
"organizationName": "A Match Made in Space, LLC",
"countryCode": "US"
},
"customerCreationTime": "2015-10-21T20:42:35.224Z"
}
עדכון לקוח קיים
כדי לעדכן לקוח קיים, משתמשים בבקשת ה-HTTP הבאה PUT
וכוללים את אסימון ההרשאה שמתואר בבקשות הרשאה. הערך customerKey
יכול להיות מזהה הלקוח הייחודי של הלקוח, או my_customer
כדי לציין את הלקוח הנוכחי.
PUT https://admin.googleapis.com/admin/directory/v1/customers/customerKey
תגובה מוצלחת מחזירה את קוד הסטטוס HTTP 200. יחד עם קוד הסטטוס, תגובת ה-JSON כוללת את נתוני הלקוח שעודכנו לאחרונה:
{
"alternateEmail": "marty.mcfly@gmail.com",
"customerDomain": "amatchmadeinspace.com",
"language": "EN",
"postalAddress": {
"organizationName": "A Match Made in Space, LLC",
"phoneNumber": "+15558675309"
}
}
תגובה מוצלחת מחזירה את קוד הסטטוס HTTP 200. יחד עם קוד הסטטוס, תגובת ה-JSON כוללת את פרטי הלקוח:
{
"etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
"kind": "admin#directory#customer",
"alternateEmail": "marty.mcfly@gmail.com",
"id": "C03xgje4y",
"customerDomain": "amatchmadeinspace.com",
"postalAddress": {
"organizationName": "A Match Made in Space, LLC",
"phoneNumber": "+15558675309"
},
"customerCreationTime": "2015-10-21T20:42:35.224Z"
}
שינוי שם הדומיין הראשי של לקוח
כדי לשנות את הדומיין הראשי של לקוח, משתמשים בבקשת ה-HTTP הבאה PUT
וכוללים את אסימון ההרשאה שמתואר בבקשות הרשאה.
הערך customerKey
חייב להיות מספר הלקוח הייחודי, או my_customer
.
PUT https://admin.googleapis.com/admin/directory/v1/customers/customerKey
גוף בקשת ה-JSON חייב לכלול את הערך החדש של customerDomain
:
{
"alternateEmail": "marty.mcfly@gmail.com",
"customerDomain": "fluxcapacitor.com",
"language": "EN",
"postalAddress": {
"organizationName": "A Match Made in Space, LLC",
"phoneNumber": "+15558675309"
}
}
תגובה מוצלחת מחזירה את קוד הסטטוס HTTP 200. יחד עם קוד הסטטוס, תגובת ה-JSON כוללת את פרטי הלקוח:
{
"etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
"kind": "admin#directory#customer",
"alternateEmail": "marty.mcfly@gmail.com",
"id": "C03xgje4y",
"customerDomain": "fluxcapacitor.com",
"postalAddress": {
"organizationName": "A Match Made in Space, LLC",
"phoneNumber": "+15558675309"
},
"customerCreationTime": "2015-10-21T20:42:35.224Z"
}