تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: locations.admins.patch
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لتحديث المشرف للموقع الجغرافي المحدّد. لا يمكن تعديل سوى دور المشرف.
طلب HTTP
PATCH https://mybusinessaccountmanagement.googleapis.com/v1/{locationAdmin.name=locations/*/admins/*}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المَعلمات |
locationAdmin.name |
string
غير قابل للتغيير. اسم المورد. بالنسبة إلى مشرفي الحساب، هذا هو النموذج: accounts/{account_id}/admins/{admin_id} بالنسبة لمشرفي المواقع الجغرافية، هذا هو النموذج: locations/{locationId}/admins/{admin_id} وسيتم تجاهل هذا الحقل في حال ضبطه أثناء إنشاء المشرف.
|
معلمات طلب البحث
| المَعلمات |
updateMask |
string (FieldMask format)
مطلوبة. الحقول المحددة التي يجب تعديلها. الحقل الوحيد القابل للتعديل هو الدور. هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"
|
نص الطلب
يحتوي نص الطلب على مثال Admin.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Admin.
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/business.manage
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول 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 document details the \u003ccode\u003ePATCH\u003c/code\u003e request to update an Admin for a specific location within a Google My Business account.\u003c/p\u003e\n"],["\u003cp\u003eOnly the AdminRole of the Admin can be updated using the \u003ccode\u003eupdateMask\u003c/code\u003e query parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires authorization using the \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eBoth the request and response bodies utilize the \u003ccode\u003eAdmin\u003c/code\u003e object for data transfer.\u003c/p\u003e\n"],["\u003cp\u003eLocation admins are identified using the \u003ccode\u003elocations/{locationId}/admins/{admin_id}\u003c/code\u003e path parameter format.\u003c/p\u003e\n"]]],["This documentation outlines how to update an Admin for a specified location via a PATCH request to the given URL. The `locationAdmin.name` path parameter identifies the admin to be updated. The `updateMask` query parameter specifies the field to modify, with only the admin's role being editable. The request body must contain an Admin instance, and the response body also returns an Admin instance if successful. The operation requires the `business.manage` OAuth scope for authorization.\n"],null,["# Method: locations.admins.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nUpdates the Admin for the specified location. Only the AdminRole of the Admin can be updated.\n\n### HTTP request\n\n`PATCH https://mybusinessaccountmanagement.googleapis.com/v1/{locationAdmin.name=locations/*/admins/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `locationAdmin.name` | `string` Immutable. The resource name. For account admins, this is in the form: `accounts/{account_id}/admins/{admin_id}` For location admins, this is in the form: `locations/{locationId}/admins/{admin_id}` This field will be ignored if set during admin creation. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask)` format)` Required. The specific fields that should be updated. The only editable field is role. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Request body\n\nThe request body contains an instance of [Admin](/my-business/reference/accountmanagement/rest/v1/accounts.admins#Admin).\n\n### Response body\n\nIf successful, the response body contains an instance of [Admin](/my-business/reference/accountmanagement/rest/v1/accounts.admins#Admin).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/business.manage`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
