Method: customers.insert
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طلب حساب عميل جديد
قبل طلب حساب عميل جديد، عليك تحديد ما إذا كان حساب العميل متوفّرًا حاليًا باستخدام customers.get.
إذا كان حساب العميل متوفّرًا كحساب Google مباشر أو كحساب عميل مُعاد بيعه من مورّد آخر، استخدِم customerAuthToken\ كما هو موضّح في طلب حساب مُعاد بيعه لعميل حالي. لمزيد من المعلومات عن طلب حساب عميل جديد، يُرجى الاطّلاع على مقالة طلب حساب عميل جديد.
بعد إنشاء حساب عميل جديد، عليك إعداد مستخدم كمشرف. على مشرف العميل تسجيل الدخول إلى "وحدة تحكّم المشرف" وتوقيع اتفاقية G Suite من خلال المورّد لتفعيل الحساب. يُحظر على المورّدين التوقيع على اتفاقية G Suite عبر مورّد بالنيابة عن العميل. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة طلب حساب عميل جديد.
طلب HTTP
POST https://reseller.googleapis.com/apps/reseller/v1/customers
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات طلب البحث
| المعلمات |
customerAuthToken |
string
يجب إدخال سلسلة طلب البحث customerAuthToken عند إنشاء حساب مُعاد بيعه ينقل اشتراك عميل مباشر أو ينقل اشتراك عميل مورِّد آخر إلى حساب إدارة المورِّد. هذا رمز مصادقة سداسي عشري مطلوب لإكمال عملية نقل الاشتراك. لمزيد من المعلومات، يُرجى الاطّلاع على مركز مساعدة المشرف.
|
نص الطلب
يحتوي نص الطلب على مثال Customer.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل تم إنشاؤه حديثًا من Customer.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/apps.order
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: customers.insert\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nOrders a new customer's account.\n\nBefore ordering a new customer account, establish whether the customer account already exists using the [`customers.get`](https://developers.google.com/workspace/admin/reseller/v1/reference/customers/get)\n\nIf the customer account exists as a direct Google account or as a resold customer account from another reseller, use the `customerAuthToken\\` as described in [order a resold account for an existing customer](https://developers.google.com/workspace/admin/reseller/v1/how-tos/manage_customers#create_existing_customer). For more information about ordering a new customer account, see [order a new customer account](https://developers.google.com/workspace/admin/reseller/v1/how-tos/manage_customers#create_customer).\n\nAfter creating a new customer account, you must provision a user as an administrator. The customer's administrator is required to sign in to the Admin console and sign the G Suite via Reseller agreement to activate the account. Resellers are prohibited from signing the G Suite via Reseller agreement on the customer's behalf. For more information, see [order a new customer account](https://developers.google.com/workspace/admin/reseller/v1/how-tos/manage_customers#tos).\n\n### HTTP request\n\n`POST https://reseller.googleapis.com/apps/reseller/v1/customers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerAuthToken` | `string` The `customerAuthToken` query string is required when creating a resold account that transfers a direct customer's subscription or transfers another reseller customer's subscription to your reseller management. This is a hexadecimal authentication token needed to complete the subscription transfer. For more information, see the [administrator help center](//support.google.com/a/bin/answer.py?answer=142336). |\n\n### Request body\n\nThe request body contains an instance of [Customer](/workspace/admin/reseller/reference/rest/v1/customers#Customer).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Customer](/workspace/admin/reseller/reference/rest/v1/customers#Customer).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/apps.order`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
