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

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

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

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

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

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

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

بازده پاسخ

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

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

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

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

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

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

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

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

به‌روزرسانی تنظیمات مشتری

با استفاده از 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 دو کاراکتری مشتری.
  • EMAIL_ADDRESS : آدرس ایمیل مشتری - برای مثال، cruz@example.com .

یک پاسخ 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"
}