Method: properties.customDimensions.patch
עדכון מאפיין מותאם אישית בנכס.
בקשת HTTP
PATCH https://analyticsadmin.googleapis.com/v1beta/{customDimension.name=properties/*/customDimensions/*}
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים |
customDimension.name |
string
פלט בלבד. שם המשאב של משאב המאפיין המותאם אישית הזה. פורמט: properties/{property}/customDimensions/{customdimension}
|
פרמטרים של שאילתה
פרמטרים |
updateMask |
string (FieldMask format)
חובה. רשימת השדות לעדכון. שדות שהושמטו לא יעודכנו. כדי להחליף את הישות כולה, צריך להשתמש בנתיב אחד עם המחרוזת "*" כדי להתאים לכל השדות. זוהי רשימה מופרדת בפסיקים של שמות מלאים של שדות. דוגמה: "user.displayName,photo"
|
גוף הבקשה
גוף הבקשה מכיל מופע של CustomDimension
.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה מכיל מופע של CustomDimension
.
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/analytics.edit
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-04-02 (שעון UTC).
[null,null,["עדכון אחרון: 2025-04-02 (שעון UTC)."],[[["This page details how to update a CustomDimension on a Google Analytics 4 property using the `PATCH` method."],["The request requires specifying the `customDimension.name` as a path parameter and an `updateMask` as a query parameter."],["The request body should contain a `CustomDimension` object with the desired updates."],["A successful response will return the updated `CustomDimension` object."],["To use this API, you need to authorize with the `https://www.googleapis.com/auth/analytics.edit` scope."]]],["This document details updating a CustomDimension on a property using a PATCH request. The URL structure, including path parameters, follows gRPC Transcoding syntax, specifying the CustomDimension's name. A required `updateMask` query parameter determines which fields to modify. The request and response bodies both use the `CustomDimension` resource. Authorization requires the `analytics.edit` OAuth scope. The `Try it!` link enables interactive testing.\n"]]