Method: properties.customDimensions.patch
อัปเดต CustomDimension ในพร็อพเพอร์ตี้
คำขอ HTTP
PATCH https://analyticsadmin.googleapis.com/v1alpha/{customDimension.name=properties/*/customDimensions/*}
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
| พารามิเตอร์ |
customDimension.name |
string
เอาต์พุตเท่านั้น ชื่อทรัพยากรสําหรับทรัพยากร CustomDimension นี้ รูปแบบ: properties/{property}/customDimensions/{customDimension}
|
พารามิเตอร์การค้นหา
| พารามิเตอร์ |
updateMask |
string (FieldMask format)
ต้องระบุ รายการช่องที่จะอัปเดต ระบบจะไม่อัปเดตช่องที่ละเว้น หากต้องการแทนที่เอนทิตีทั้งหมด ให้ใช้เส้นทางเดียวที่มีสตริง "*" เพื่อจับคู่กับทุกช่อง ซึ่งเป็นรายการชื่อฟิลด์ที่สมบูรณ์ในตัวเองที่คั่นด้วยคอมมา ตัวอย่าง: "user.displayName,photo"
|
เนื้อหาของคำขอ
เนื้อความของคำขอมีอินสแตนซ์ของ CustomDimension
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ CustomDimension
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/analytics.edit
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-01-14 UTC
[null,null,["อัปเดตล่าสุด 2025-01-14 UTC"],[[["Updates a specified CustomDimension on a Google Analytics 4 property using an HTTP PATCH request."],["The request should target a URL containing the property and CustomDimension identifiers, using gRPC Transcoding syntax."],["Users must provide an `updateMask` query parameter to specify the fields to update within the CustomDimension."],["The request body must contain a CustomDimension object with the desired changes and the response will contain the updated CustomDimension."],["Authorization requires the `https://www.googleapis.com/auth/analytics.edit` OAuth scope."]]],["This document details updating a CustomDimension on a property using a PATCH request. The endpoint is `https://analyticsadmin.googleapis.com/v1alpha/{customDimension.name=properties/*/customDimensions/*}`. Required parameters include the `customDimension.name` path parameter and the `updateMask` query parameter, which specifies fields to be updated. The request body contains a CustomDimension instance, and the successful response returns an updated CustomDimension instance. The process requires `https://www.googleapis.com/auth/analytics.edit` authorization scope.\n"]]
