Method: properties.delete
הפונקציה מסמנת את נכס היעד כנכס שנמחק באופן סופי (כלומר, 'הועבר לאשפה') ומחזירה אותו.
ל-API הזה אין שיטה לשחזור נכסים שנמחקו באופן סופי. עם זאת, אפשר לשחזר אותם באמצעות ממשק המשתמש של פח האשפה.
אם הנכסים לא ישוחזרו לפני מועד התפוגה, הנכס וכל המשאבים הצאצאים (למשל: GoogleAdsLinks, Streams, AccessBindings) יימחקו לתמיד. https://support.google.com/analytics/answer/6154772
הפונקציה מחזירה שגיאה אם היעד לא נמצא.
בקשת HTTP
DELETE https://analyticsadmin.googleapis.com/v1alpha/{name=properties/*}
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים |
name |
string
חובה. השם של הנכס שרוצים למחוק באופן סופי. פורמט: properties/{property_id}. דוגמה: "properties/1000"
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של Property
.
היקפי הרשאה
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/analytics.edit
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-01-14 (שעון UTC).
[null,null,["עדכון אחרון: 2025-01-14 (שעון UTC)."],[[["This API allows for the soft deletion of a Google Analytics 4 property, essentially moving it to the trash."],["Soft-deleted properties and their associated resources are permanently deleted after a period; they can be restored before that time via the Trash Can UI."],["The API requires a DELETE request with the property ID specified in the path, and an empty request body."],["Upon successful execution, the API returns the soft-deleted Property object in the response body."],["To use this API, you need the `https://www.googleapis.com/auth/analytics.edit` OAuth scope."]]],["This API soft-deletes a specified property identified by its name (e.g., \"properties/1000\") via a `DELETE` HTTP request. The request body must be empty. Upon success, it returns the soft-deleted Property. Soft-deleted properties can be restored through the Trash Can UI but will be permanently purged if not restored before their expiration time. The required authorization scope is `https://www.googleapis.com/auth/analytics.edit`. An error is returned if the property is not found.\n"]]