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

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

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

برای بازیابی یک مشتری موجود، از درخواست 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"
}