החל מ-8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין בדף ההוצאה משימוש.
אזהרה: פריטים שהוגדרו להם טריגרים ידניים לא מוצגים יותר בקמפיינים לרשת המדיה וידאו 360 השיטה הזו תצא משימוש ב-1 באוגוסט 2023. למידע נוסף, אפשר לקרוא את ההודעה על הוצאה משימוש של תכונות.
בקשת HTTP
GET https://displayvideo.googleapis.com/v1/advertisers/{advertiserId}/manualTriggers
חובה. המזהה של המפרסם שאליו שייכים הטריגרים הידניים שנשלפו.
פרמטרים של שאילתה
פרמטרים
pageSize
integer
גודל הדף המבוקש. חייב להיות בין 1 ל-200. אם לא צויין ערך, ברירת המחדל תהיה 100.
pageToken
string
אסימון שמזהה דף תוצאות שהשרת צריך להחזיר. בדרך כלל, זהו הערך של nextPageToken שהוחזר מהקריאה הקודמת ל-method manualTriggers.list. אם לא מציינים זאת, המערכת תחזיר את דף התוצאות הראשון.
orderBy
string
השדה שלפיו צריך למיין את הרשימה. הערכים הקבילים הם:
displayName (ברירת מחדל)
state
ברירת המחדל של סדר המיון היא בסדר עולה. כדי לציין סדר יורד בשדה, הסיומת 'תיאור' יש להוסיף לשם השדה. לדוגמה, displayName desc.
filter
string
מאפשר סינון לפי שדות הפעלה ידניים.
תחביר נתמך:
ביטויי הסינון מורכבים מהגבלה אחת או יותר.
אפשר לשלב את ההגבלות באמצעות אופרטורים לוגיים AND או OR. רצף של הגבלות משתמש באופן מרומז ב-AND.
הגבלה היא בפורמט {field} {operator} {value}.
צריך להשתמש באופרטור EQUALS (=) בכל השדות.
שדות נתמכים:
displayName
state
דוגמאות:
כל הטריגרים הידניים הפעילים אצל מפרסם: state="ACTIVE"
אסימון לאחזור של דף התוצאות הבא. מעבירים את הערך הזה בשדה [pageToken][ListManualTriggersResponse.page_token] בקריאה הבאה ל-method manualTriggers.list, כדי לאחזר את דף התוצאות הבא.
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\u003cp\u003eLists existing manual triggers associated with a specific Display & Video 360 advertiser ID.\u003c/p\u003e\n"],["\u003cp\u003eManual triggers no longer serve ads and this feature will be sunset on August 1, 2023.\u003c/p\u003e\n"],["\u003cp\u003eResults can be filtered by display name, state, and ordered by various fields.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,["# Method: advertisers.manualTriggers.list\n\n| Display \\& Video 360 API v1 has been sunset.\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 - [JSON representation](#body.ListManualTriggersResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists manual triggers that are accessible to the current user for a given advertiser ID.\n\nThe order is defined by the [orderBy](/display-video/api/reference/rest/v1/advertisers.manualTriggers/list#body.QUERY_PARAMETERS.order_by) parameter.\n\nA single [advertiserId](/display-video/api/reference/rest/v1/advertisers.manualTriggers/list#body.PATH_PARAMETERS.advertiser_id) is required.\n\n**Warning:** Line Items using manual triggers no longer serve in Display \\& Video 360. This method will sunset on August 1, 2023. Read our [feature deprecation announcement](/display-video/api/deprecations#features.manual_triggers) for more information.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v1/advertisers/{advertiserId}/manualTriggers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the advertiser that the fetched manual triggers belong to. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Requested page size. Must be between `1` and `200`. If unspecified will default to `100`. |\n| `pageToken` | `string` A token identifying a page of results the server should return. Typically, this is the value of [nextPageToken](/display-video/api/reference/rest/v1/advertisers.manualTriggers/list#body.ListManualTriggersResponse.FIELDS.next_page_token) returned from the previous call to `manualTriggers.list` method. If not specified, the first page of results will be returned. |\n| `orderBy` | `string` Field by which to sort the list. Acceptable values are: - `displayName` (default) - `state` The default sorting order is ascending. To specify descending order for a field, a suffix \"desc\" should be added to the field name. For example, `displayName desc`. |\n| `filter` | `string` Allows filtering by manual trigger fields. Supported syntax: - Filter expressions are made up of one or more restrictions. - Restrictions can be combined by `AND` or `OR` logical operators. A sequence of restrictions implicitly uses `AND`. - A restriction has the form of `{field} {operator} {value}`. - All fields must use the `EQUALS (=)` operator. Supported fields: - `displayName` - `state` Examples: - All active manual triggers under an advertiser: `state=\"ACTIVE\"` The length of this field should be no more than 500 characters. Reference our [filter `LIST` requests](/display-video/api/guides/how-tos/filters) guide for more information. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"manualTriggers\": [ { object (/display-video/api/reference/rest/v1/advertisers.manualTriggers#ManualTrigger) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `manualTriggers[]` | `object (`[ManualTrigger](/display-video/api/reference/rest/v1/advertisers.manualTriggers#ManualTrigger)`)` The list of manual triggers. This list will be absent if empty. |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Pass this value in the \\[pageToken\\]\\[ListManualTriggersResponse.page_token\\] field in the subsequent call to `manualTriggers.list` method to retrieve the next page of results. |\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
