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

شما می‌توانید از 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": "yuri@example.com",
  "id": "C03xgje4y",
  "customerDomain": "example.com",
  "postalAddress": {
    "organizationName": "Example.com",
    "countryCode": "US"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}

به‌روزرسانی مشتری فعلی

برای به‌روزرسانی یک مشتری موجود، از درخواست PUT زیر استفاده کنید و توکن مجوز شرح داده شده در درخواست‌های مجوز را نیز وارد کنید. customerKey می‌تواند customerId منحصر به فرد مشتری یا my_customer برای نشان دادن مشتری فعلی باشد.

PUT https://admin.googleapis.com/admin/directory/v1/customers/customerKey

یک پاسخ موفق، کد وضعیت HTTP 200 را برمی‌گرداند. پاسخ JSON علاوه بر کد وضعیت، شامل اطلاعات مشتری که به تازگی به‌روزرسانی شده است نیز می‌شود:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "yuri@example.com",
  "id": "C03xgje4y",
  "customerDomain": "example.com",
  "postalAddress": {
    "organizationName": "Example.com",
    "phoneNumber": "+15558675309"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}

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

برای تغییر دامنه اصلی مشتری، از درخواست PUT زیر استفاده کنید و توکن مجوز شرح داده شده در درخواست‌های مجوز را نیز وارد کنید. کلید customerKey باید یک customerId منحصر به فرد یا my_customer باشد.

PUT https://admin.googleapis.com/admin/directory/v1/customers/customerKey

بدنه درخواست JSON باید شامل مقدار جدید customerDomain باشد:

{
  "alternateEmail": "yuri@example.com",
  "customerDomain": "example.com",
  "language": "EN",
  "postalAddress": {
    "organizationName": "Example.com",
    "phoneNumber": "+15558675309"
  }
}

یک پاسخ موفق، کد وضعیت HTTP 200 را برمی‌گرداند. پاسخ JSON علاوه بر کد وضعیت، شامل اطلاعات مشتری نیز می‌شود:

{
  "etag": "\"spqlTgq5LGeoin0BH1d0f4rpI98/LnbnRK_ZWu_omowg36CZgTKECrY\"",
  "kind": "admin#directory#customer",
  "alternateEmail": "yuri@example.com",
  "id": "C03xgje4y",
  "customerDomain": "example.com",
  "postalAddress": {
    "organizationName": "Example.com",
    "phoneNumber": "+15558675309"
  },
  "customerCreationTime": "2015-10-21T20:42:35.224Z"
}