تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
Method: accounts.patch
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعديل حساب النشاط التجاري المحدّد لا يمكن تحديث الحسابات الشخصية باستخدام هذه الطريقة.
طلب HTTP
PATCH https://mybusinessaccountmanagement.googleapis.com/v1/{account.name=accounts/*}
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المَعلمات |
account.name |
string
غير قابل للتغيير. اسم المورد بالتنسيق accounts/{account_id}.
|
معلمات طلب البحث
| المَعلمات |
updateMask |
string (FieldMask format)
مطلوبة. الحقول المحددة التي يجب تعديلها. الحقل الوحيد القابل للتعديل هو accountName. هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"
|
validateOnly |
boolean
اختياريّ. إذا كانت الإجابة "صحيح"، يتم التحقّق من صحة الطلب بدون تعديل الحساب فعليًا.
|
نص الطلب
يحتوي نص الطلب على مثال Account.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Account.
نطاقات التفويض
يجب توفير نطاق 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 process for updating a specified business account using the \u003ccode\u003ePATCH\u003c/code\u003e method with the provided URL, specifically targeting the \u003ccode\u003eaccountName\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003eThe request necessitates specific path and query parameters, including \u003ccode\u003eaccount.name\u003c/code\u003e for account identification and \u003ccode\u003eupdateMask\u003c/code\u003e to specify the fields for modification.\u003c/p\u003e\n"],["\u003cp\u003eIt requires the use of an \u003ccode\u003eAccount\u003c/code\u003e object in both the request and response bodies, along with authorization using the \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThis method is applicable to business accounts only; personal accounts cannot be updated using this approach, and a validation-only mode can be enabled by setting the \u003ccode\u003evalidateOnly\u003c/code\u003e query parameter.\u003c/p\u003e\n"]]],["This describes updating a business account via a `PATCH` request to `https://mybusinessaccountmanagement.googleapis.com/v1/{account.name=accounts/*}`. The `account.name` path parameter, using the format `accounts/{account_id}`, identifies the target account. The `updateMask` query parameter, which is required, specifies editable fields, with `accountName` as the only allowed field. You can also add the `validateOnly` parameter. The request and response bodies both contain an `Account` instance. The operation requires the `https://www.googleapis.com/auth/business.manage` authorization scope.\n"],null,["# Method: accounts.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 specified business account. Personal accounts cannot be updated using this method.\n\n### HTTP request\n\n`PATCH https://mybusinessaccountmanagement.googleapis.com/v1/{account.name=accounts/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|-------------------------------------------------------------------------------|\n| `account.name` | `string` Immutable. The resource name, in the format `accounts/{account_id}`. |\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 `accountName`. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n| `validateOnly` | `boolean` Optional. If true, the request is validated without actually updating the account. |\n\n### Request body\n\nThe request body contains an instance of [Account](/my-business/reference/accountmanagement/rest/v1/accounts#Account).\n\n### Response body\n\nIf successful, the response body contains an instance of [Account](/my-business/reference/accountmanagement/rest/v1/accounts#Account).\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)."]]
