بازیابی & اطلاعات حساب مشتری را به روز کنید

برای بازیابی و به روز رسانی اطلاعات مشتری با استفاده از Reseller API، یکی از دو راه برای جستجوی مشتری خود دارید:

• شناسه منحصر به فرد مشتری - برای مثال، C0123456
• نام دامنه مشتری - به عنوان مثال، example.com

اطلاعات حساب مشتری را بازیابی کنید

برای بازیابی اطلاعات حساب مشتری، از درخواست GET زیر استفاده کنید و رمز مجوز را وارد کنید:

GET https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

CUSTOMER_ID با شناسه یا نام دامنه منحصر به فرد مشتری خود جایگزین کنید.

پاسخ برمی گردد

وقتی اطلاعات حساب مشتری را بازیابی می کنید، ممکن است یکی از پاسخ های زیر را دریافت کنید:

• تنظیمات کامل مشتری را برمی گرداند. مشتری یکی از مشتریان فعلی شماست. با استفاده از Reseller API، می‌توانید تنظیمات حساب و اشتراک این مشتری را مدیریت کنید.

• حداقل اطلاعات حساب مشتری را برمی گرداند. اگر پاسخ فقط customerId ، customerDomain و customerType را برمی گرداند، یا Google یا فروشنده دیگری مشتری را مدیریت می کند. شما نمی توانید مشتری تایید شده توسط ایمیل دیگری برای مشتری ایجاد کنید. برای مدیریت این مشتری مراحل زیر را دنبال کنید:

  1. همه اشتراک‌های قابل انتقال را برای مشتری بازیابی کنید تا بفهمید آیا اشتراک قابل انتقال است و حداقل تعداد صندلی‌های کاربر برای انتقال.
  2. انتقال اشتراک

• بازده Multiple teams exist on this domain . این دامنه دارای یک یا چند مشتری تیم مرتبط با آن است. برای افزودن تیم دیگری به این دامنه، مراحل زیر را دنبال کنید:

  1. سفارش حساب مشتری
  2. برای ایجاد یک مشتری تأیید شده با دامنه برای دامنه، از مشتری بخواهید اشتراک مستقیم از طریق Google خریداری کند و دامنه خود را تأیید کند، تیم های موجود را تصاحب کند و سپس اشتراک را به حساب شما منتقل کند .

• یک خطای HTTP 404 را برمی گرداند. مشتری تازه وارد Google است و حسابی ندارد. برای مدیریت این مشتری مراحل زیر را دنبال کنید:

  1. تأیید کنید که سوابق مشتری شما داده‌های مشتری قدیمی را با عدم تطابق احتمالی نام دامنه اصلی مشتری و شناسه منحصربه‌فرد مشتری Google حفظ نمی‌کند. هنگامی که یک حساب Google قبلاً حذف شده بازیابی می شود، به عنوان یک حساب جدید تلقی می شود و دارای یک مقدار customerId جدید است حتی اگر حساب ممکن است همان مقدار customerDomain را حفظ کند.
  2. سفارش یک حساب مشتری جدید
  3. یک اشتراک برای این حساب مشتری جدید ایجاد کنید .

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

با استفاده از Reseller API، نمی‌توانید customerType را به‌روزرسانی کنید، اما می‌توانید دامنه مشتری team را تأیید کنید و مشتری domain شوید.

برای به‌روزرسانی تنظیمات مشتری، از درخواست PUT زیر استفاده کنید و شناسه منحصربه‌فرد مشتری خود را وارد کنید:

PUT https://reseller.googleapis.com/apps/reseller/v1/customers/CUSTOMER_ID

بدنه درخواست JSON تنظیمات مشتری زیر را به روز می کند:

{
  "customerId": "C0CUSTOMER_ID123456",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

موارد زیر را جایگزین کنید:

• DOMAIN_NAME : دامنه مشتری شما—مثلا example.com
• NAME : نام مشتری شما - به عنوان مثال، Alex Cruz .
• ORGANIZATION_NAME : نام سازمان مشتری شما—به عنوان مثال، Example Organization .
• POSTAL_CODE : کد پستی یا کد پستی مشتری شما—مثلا 94043 .
• COUNTRY_CODE : کد کشور ISO 2 کاراکتری مشتری شما.
• EMAIL_ADDRESS : آدرس ایمیل مشتری شما - برای مثال [e-mail] .

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

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}