החל מ-
8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין ב
דף ההוצאה משימוש.
Method: users.patch
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
עדכון של משתמש קיים. הפונקציה מחזירה את המשתמש המעודכן אם הפעולה בוצעה בהצלחה.
לשיטה הזו יש דרישות אימות ייחודיות. לפני שמשתמשים בשיטה הזו, כדאי לקרוא את הדרישות המוקדמות שמפורטות במדריך לניהול משתמשים.
התכונה 'ניסיון השיטה הזו' לא פועלת בשיטה הזו.
בקשת HTTP
PATCH https://displayvideo.googleapis.com/v4/users/{user.userId}
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים |
user.userId |
string (int64 format)
פלט בלבד. המזהה הייחודי של המשתמש. המערכת מקצה את השם.
|
פרמטרים של שאילתה
| פרמטרים |
updateMask |
string (FieldMask format)
חובה. המסכה שמאפשרת לקבוע אילו שדות יעודכנו. זוהי רשימה של שמות שדות מוגדרים במלואם, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"
|
גוף הבקשה
גוף הבקשה מכיל מופע של User.
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של User.
היקפי הרשאה
נדרשת הרשאת OAuth ברמה הבאה:
https://www.googleapis.com/auth/display-video-user-management
מידע נוסף זמין בOAuth 2.0 Overview.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[],["The Display & Video 360 API v4, in beta, enables updating existing users via a PATCH request to `https://displayvideo.googleapis.com/v4/users/{user.userId}`. It uses gRPC Transcoding and requires specific authentication prerequisites. The `updateMask` query parameter is mandatory, specifying the fields for modification. The request body contains user data, and successful responses return the updated user. OAuth scope `https://www.googleapis.com/auth/display-video-user-management` is needed for authorization. The try method feature is unavailable.\n"],null,["# Method: users.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- [Try it!](#try-it)\n\nUpdates an existing user. Returns the updated user if successful.\n\nThis method has unique authentication requirements. Read the prerequisites in our [Managing Users guide](/display-video/api/guides/users/overview#prerequisites) before using this method.\n\nThe \"Try this method\" feature does not work for this method.\n\n### HTTP request\n\n`PATCH https://displayvideo.googleapis.com/v4/users/{user.userId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|\n| `user.userId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The unique ID of the user. Assigned by the system. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Required. The mask to control which fields to update. 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 [User](/display-video/api/reference/rest/v4/users#User).\n\n### Response body\n\nIf successful, the response body contains an instance of [User](/display-video/api/reference/rest/v4/users#User).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video-user-management`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
