يمكنك استخدام Directory API لإدارة عملائك آليًا. تتيح لك الطرق في واجهة برمجة التطبيقات هذه تحديث معلومات الاتصال على نطاقك في G Suite، بالإضافة إلى تغيير النطاق الأساسي لمثيل مؤسستك.
استرداد عميل
لاسترداد عميل حالي، استخدِم طلب HTTP GET
التالي مع تضمين الرمز المميّز للتفويض الموضّح في طلبات التفويض. يمكن أن يكون
customerKey
هو customerId الفريد أو 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"
}