Directory API: مدیریت مشتریان

می توانید از Directory API برای مدیریت برنامه ریزی مشتریان خود استفاده کنید. روش‌های موجود در این API به شما امکان می‌دهند اطلاعات تماس دامنه G Suite خود را به‌روزرسانی کنید و همچنین دامنه اصلی را برای نمونه خود تغییر دهید.

یک مشتری را بازیابی کنید

برای بازیابی یک مشتری موجود، از درخواست GET HTTP زیر استفاده کنید و کد مجوز توضیح داده شده در درخواست‌های مجوز را وارد کنید. 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"
}

یک مشتری موجود را به روز کنید

برای به‌روزرسانی یک مشتری موجود، از درخواست PUT HTTP زیر استفاده کنید و کد مجوز توضیح داده شده در درخواست‌های مجوزدهی را اضافه کنید. 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"
}

تغییر نام دامنه اصلی مشتری

برای تغییر دامنه اصلی مشتری، از درخواست PUT HTTP زیر استفاده کنید و کد مجوز توضیح داده شده در درخواست‌های مجاز را اضافه کنید. customerKey باید یک customerId یا 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"
}