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
אפשרות. אם הערך הוא True, הבקשה מאומתת בלי לעדכן את החשבון בפועל.
|
גוף הבקשה
גוף הבקשה מכיל מופע של 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 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\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)."]]
