از 8 سپتامبر 2025 ، هر مورد خط جدید باید اعلام کند که آیا تبلیغات سیاسی اتحادیه اروپا (EU) را ارائه می دهد یا خیر. Display & Video 360 API و بارگذاری‌های SDF که اعلان‌ها را ارائه نمی‌کنند با شکست مواجه می‌شوند. برای جزئیات بیشتر در مورد نحوه به روز رسانی یکپارچه سازی خود برای ایجاد این اعلامیه، به صفحه لغو اعتبار ما مراجعه کنید.
هشدار: موارد خطی که از محرک‌های دستی استفاده می‌کنند دیگر در Display & Video 360 استفاده نمی‌شوند. این روش در 1 اوت 2023 غروب می‌کند. برای اطلاعات بیشتر اعلامیه لغو ویژگی ما را بخوانید.
درخواست HTTP
GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/manualTriggers
مورد نیاز. شناسه تبلیغ‌کننده که راه‌اندازهای دستی واکشی شده به آن تعلق دارند.
پارامترهای پرس و جو
پارامترها
pageSize
integer
اندازه صفحه درخواستی باید بین 1 تا 200 باشد. اگر نامشخص باشد به طور پیش فرض 100 خواهد بود.
pageToken
string
نشانه ای که صفحه ای از نتایجی را که سرور باید برگرداند، شناسایی کند. به طور معمول، این مقدار nextPageToken است که از فراخوانی قبلی به روش manualTriggers.list برگردانده شده است. اگر مشخص نشده باشد، صفحه اول نتایج برگردانده خواهد شد.
orderBy
string
فیلدی که بر اساس آن لیست مرتب می شود. مقادیر قابل قبول عبارتند از:
displayName (پیش‌فرض)
state
ترتیب مرتب سازی پیش فرض صعودی است. برای تعیین ترتیب نزولی برای یک فیلد، پسوند "desc" باید به نام فیلد اضافه شود. برای مثال displayName desc .
filter
string
اجازه می دهد تا فیلتر توسط فیلدهای ماشه دستی.
نحو پشتیبانی شده:
عبارات فیلتر از یک یا چند محدودیت تشکیل شده اند.
محدودیت ها را می توان با عملگرهای منطقی AND یا OR ترکیب کرد. دنباله ای از محدودیت ها به طور ضمنی از AND استفاده می کند.
یک محدودیت به شکل {field} {operator} {value} است.
همه فیلدها باید از عملگر EQUALS (=) استفاده کنند.
زمینه های پشتیبانی شده:
displayName
state
مثال ها:
همه محرک‌های دستی فعال تحت یک تبلیغ‌کننده: state="ACTIVE"
نشانه ای برای بازیابی صفحه بعدی نتایج. این مقدار را در قسمت [pageToken][ListManualTriggersResponse.page_token] در فراخوانی بعدی به روش manualTriggers.list ارسال کنید تا صفحه بعدی نتایج را بازیابی کنید.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eLists manual triggers accessible to the current user for a specific advertiser, ordered by displayName or state.\u003c/p\u003e\n"],["\u003cp\u003eManual triggers no longer serve in Display & Video 360 and this method will be sunset on August 1, 2023.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the advertiser ID and allows filtering and pagination of results.\u003c/p\u003e\n"],["\u003cp\u003eReturns a list of manual triggers with details and a token for retrieving subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eNeeds authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document outlines how to list manual triggers for a specific advertiser ID using the Display & Video 360 API, which has now sunset. A `GET` request to a specific URL using the `advertiserId` in the path is used. Optional query parameters include `pageSize`, `pageToken`, `orderBy`, and `filter` for refining results. The response returns a list of `manualTriggers` and a `nextPageToken` for pagination. Line Items using this method no longer serve and will sunset on August 1, 2023.\n"],null,["# Method: advertisers.manualTriggers.list\n\n| Display \\& Video 360 API v2 has 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/v2/advertisers.manualTriggers/list#body.QUERY_PARAMETERS.order_by) parameter.\n\nA single [advertiserId](/display-video/api/reference/rest/v2/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/v2/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/v2/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/v2/advertisers.manualTriggers#ManualTrigger) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `manualTriggers[]` | `object (`[ManualTrigger](/display-video/api/reference/rest/v2/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)."]]
