Method: partners.customers.create
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تنشئ حسابًا للعميل لبرنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة". بعد إرجاع الطريقة بنجاح، يمكن لأدوار المشرف والمالك إدارة الأجهزة وإعدادات إدارة الخدمات الجوّالة للمؤسسات (EMM) من خلال طلب بيانات طرق واجهة برمجة التطبيقات أو استخدام منصة "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة". يتلقّى العميل رسالة إلكترونية للترحيب به في برنامج "إعداد الأجهزة الجوّالة للمؤسّسات دفعةً واحدة" مع توضيح كيفية تسجيل الدخول إلى البوابة.
طلب HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=partners/*}/customers
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
مطلوب. تمثّل هذه السمة رقم تعريف المورد الرئيسي بالتنسيق partners/[PARTNER_ID] الذي يحدّد المورّد.
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
{
"customer": {
object (Company)
}
} |
| الحقول |
customer |
object (Company)
مطلوب. بيانات الشركة لتعبئة العميل الجديد. يجب أن يحتوي على قيمة لـ companyName وowner_email واحد على الأقل مقترن بحساب Google. يجب أن تكون قيمتا companyId وname فارغة.
|
نص الاستجابة
في حال نجاح الإجراء، يحتوي نص الاستجابة على مثيل Company تم إنشاؤه حديثًا.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidworkprovisioning
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis endpoint creates a new customer for zero-touch enrollment, enabling them to manage devices and EMM configurations via API or the zero-touch portal.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request is a \u003ccode\u003ePOST\u003c/code\u003e to \u003ccode\u003ehttps://androiddeviceprovisioning.googleapis.com/v1/{parent=partners/*}/customers\u003c/code\u003e, using gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required and identifies the reseller in the format \u003ccode\u003epartners/[PARTNER_ID]\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include a \u003ccode\u003ecustomer\u003c/code\u003e object with the company name and at least one owner email associated with a Google Account.\u003c/p\u003e\n"],["\u003cp\u003eSuccessfully creating a customer returns a \u003ccode\u003eCompany\u003c/code\u003e instance, and the operation requires the \u003ccode\u003ehttps://www.googleapis.com/auth/androidworkprovisioning\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This describes how to create a zero-touch enrollment customer using a POST request to `https://androiddeviceprovisioning.googleapis.com/v1/{parent=partners/*}/customers`. The `parent` path parameter specifies the reseller. The request body must include a `customer` object with a `companyName` and at least one `owner_email`. Upon success, a new `Company` instance is returned. Authorization requires the `https://www.googleapis.com/auth/androidworkprovisioning` OAuth scope. The created customer can then manage devices and EMM configs.\n"],null,["# Method: partners.customers.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization Scopes](#body.aspect)\n\nCreates a customer for zero-touch enrollment. After the method returns successfully, admin and owner roles can manage devices and EMM configs by calling API methods or using their zero-touch enrollment portal. The customer receives an email that welcomes them to zero-touch enrollment and explains how to sign into the portal.\n\n### HTTP request\n\n`POST https://androiddeviceprovisioning.googleapis.com/v1/{parent=partners/*}/customers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|---------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent resource ID in the format `partners/[PARTNER_ID]` that identifies the reseller. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation ||\n|--------------------------------------------------------------------------------------------------------|---|\n| ``` { \"customer\": { object (/zero-touch/reference/reseller/rest/v1/partners.customers#Company) } } ``` |\n\n| Fields ||\n|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customer` | `object (`[Company](/zero-touch/reference/reseller/rest/v1/partners.customers#Company)`)` Required. The company data to populate the new customer. Must contain a value for `companyName` and at least one `owner_email` that's associated with a Google Account. The values for `companyId` and `name` must be empty. |\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Company](/zero-touch/reference/reseller/rest/v1/partners.customers#Company).\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidworkprovisioning`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
