از
8 سپتامبر 2025 ، هر مورد خط جدید باید اعلام کند که آیا تبلیغات سیاسی اتحادیه اروپا (EU) را ارائه می دهد یا خیر. Display & Video 360 API و بارگذاری‌های SDF که اعلان‌ها را ارائه نمی‌کنند با شکست مواجه می‌شوند. برای جزئیات بیشتر در مورد نحوه به روز رسانی یکپارچه سازی خود برای ایجاد این اعلامیه، به
صفحه لغو اعتبار ما مراجعه کنید.
Method: customBiddingAlgorithms.scripts.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
اسکریپت های پیشنهادی سفارشی که به الگوریتم داده شده تعلق دارند را فهرست می کند.
ترتیب با پارامتر orderBy تعریف می شود.
درخواست HTTP
GET https://displayvideo.googleapis.com/v4/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
customBiddingAlgorithmId | string ( int64 format) مورد نیاز. شناسه الگوریتم مناقصه سفارشی مالک اسکریپت است. |
پارامترهای پرس و جو
| پارامترها |
|---|
pageSize | integer اندازه صفحه درخواستی باید بین 1 تا 200 باشد. اگر نامشخص باشد به طور پیش فرض 100 خواهد بود. اگر مقدار نامعتبری مشخص شده باشد، کد خطا INVALID_ARGUMENT را برمی‌گرداند. |
pageToken | string نشانه ای که صفحه ای از نتایجی را که سرور باید برگرداند، شناسایی کند. به طور معمول، این مقدار nextPageToken است که از فراخوانی قبلی به روش scripts.list بازگردانده می شود. اگر مشخص نشده باشد، صفحه اول نتایج برگردانده خواهد شد. |
orderBy | string فیلدی که بر اساس آن لیست مرتب می شود. مقادیر قابل قبول عبارتند از: -
createTime desc (پیش‌فرض)
ترتیب مرتب سازی پیش فرض نزولی است. برای تعیین ترتیب صعودی برای یک فیلد، پسوند "desc" باید حذف شود. مثال: createTime . |
accessor پارامتر اتحادیه مورد نیاز. موجودیت DV360 را که مالک الگوریتم مناقصه سفارشی والد است، شناسایی می کند. این می تواند یک شریک یا یک تبلیغ کننده باشد. accessor می تواند تنها یکی از موارد زیر باشد: |
partnerId | string ( int64 format) شناسه شریکی که دارای الگوریتم مناقصه سفارشی والد است. فقط این شریک دسترسی نوشتن به این اسکریپت پیشنهادی سفارشی خواهد داشت. |
advertiserId | string ( int64 format) شناسه تبلیغ‌کننده‌ای که مالک الگوریتم مناقصه سفارشی والدین است. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"customBiddingScripts": [
{
object (CustomBiddingScript)
}
],
"nextPageToken": string
} |
| فیلدها |
|---|
customBiddingScripts[] | object ( CustomBiddingScript ) لیست اسکریپت های پیشنهادی سفارشی. در صورت خالی بودن این لیست وجود نخواهد داشت. |
nextPageToken | string نشانه ای برای بازیابی صفحه بعدی نتایج. این مقدار را در قسمت pageToken در فراخوانی بعدی به روش ListCustomBiddingScriptsRequest ارسال کنید تا صفحه بعدی نتایج را بازیابی کنید. اگر این فیلد null باشد یعنی این صفحه آخر است. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/display-video
برای اطلاعات بیشتر، بهOAuth 2.0 Overview .
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],["This API lists custom bidding scripts associated with a specified algorithm using a `GET` request. You must provide the `customBiddingAlgorithmId`. You can filter the results using query parameters like `pageSize`, `pageToken`, and `orderBy`. The `accessor` parameter is required and accepts either a `partnerId` or `advertiserId` for ownership. The response includes a list of `customBiddingScripts` and a `nextPageToken` for pagination. Requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"],null,["# Method: customBiddingAlgorithms.scripts.list\n\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.ListCustomBiddingScriptsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists custom bidding scripts that belong to the given algorithm.\n\nThe order is defined by the [orderBy](/display-video/api/reference/rest/v4/customBiddingAlgorithms.scripts/list#body.QUERY_PARAMETERS.order_by) parameter.\n\n### HTTP request\n\n`GET https://displayvideo.googleapis.com/v4/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customBiddingAlgorithmId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the custom bidding algorithm owns the script. |\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`. Returns error code `INVALID_ARGUMENT` if an invalid value is specified. |\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/v4/customBiddingAlgorithms.scripts/list#body.ListCustomBiddingScriptsResponse.FIELDS.next_page_token) returned from the previous call to `scripts.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: - `createTime desc` (default) The default sorting order is descending. To specify ascending order for a field, the suffix \"desc\" should be removed. Example: `createTime`. |\n| Union parameter `accessor`. Required. Identifies the DV360 entity that owns the parent custom bidding algorithm. It can be either a partner or an advertiser. `accessor` can be only one of the following: ||\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the partner that owns the parent custom bidding algorithm. Only this partner will have write access to this custom bidding script. |\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that owns the parent custom bidding algorithm. |\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| ``` { \"customBiddingScripts\": [ { object (/display-video/api/reference/rest/v4/customBiddingAlgorithms.scripts#CustomBiddingScript) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customBiddingScripts[]` | `object (`[CustomBiddingScript](/display-video/api/reference/rest/v4/customBiddingAlgorithms.scripts#CustomBiddingScript)`)` The list of custom bidding scripts. 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](/display-video/api/reference/rest/v4/customBiddingAlgorithms.scripts/list#body.QUERY_PARAMETERS.page_token) field in the subsequent call to `ListCustomBiddingScriptsRequest` method to retrieve the next page of results. If this field is null, it means this is the last page. |\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](/identity/protocols/OAuth2)."]]
