Method: advertisers.creatives.delete
מחיקה של קריאייטיב. הפונקציה מחזירה את קוד השגיאה NOT_FOUND אם הקריאייטיב לא קיים. כדי למחוק את הקריאייטיב, צריך קודם להעביר אותו לארכיון, כלומר להגדיר את entityStatus כ-ENTITY_STATUS_ARCHIVED.
כדי לשלוח את הבקשה הזו, צריך תפקיד משתמש 'רגיל' או תפקיד גבוה יותר בחשבון המפרסם או השותף ברמה ה'הורה'.
בקשת HTTP
DELETE https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/creatives/{creativeId}
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים |
advertiserId |
string (int64 format)
המזהה של המפרסם שאליו שייך הקריאייטיב.
|
creativeId |
string (int64 format)
המזהה של הקריאייטיב שרוצים למחוק.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה הוא אובייקט JSON ריק.
היקפי הרשאה
נדרש היקף הרשאות OAuth הבא:
https://www.googleapis.com/auth/display-video
מידע נוסף זמין בOAuth 2.0 Overview.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-02-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-02-25 (שעון UTC)."],[[["Deletes a specified creative belonging to an advertiser, requiring prior archival of the creative."],["Only users with \"Standard\" role or higher for the parent advertiser or partner can perform this deletion."],["The request utilizes a `DELETE` method with advertiser and creative IDs as path parameters, and an empty request body."],["A successful deletion results in an empty response body, while a non-existent creative triggers a `NOT_FOUND` error."],["Authorization necessitates the `https://www.googleapis.com/auth/display-video` OAuth scope."]]],["This document details the process of deleting a creative within an advertiser's account. Deletion requires a \"Standard\" or greater user role. The creative must first be archived by setting its `entityStatus` to `ENTITY_STATUS_ARCHIVED`. A `DELETE` HTTP request is sent to the specified URL, including `advertiserId` and `creativeId` as path parameters. The request body should be empty. A successful deletion returns an empty JSON object; if the creative doesn't exist, `NOT_FOUND` is returned. The operation requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"]]
