از
8 سپتامبر 2025 ، هر مورد خط جدید باید اعلام کند که آیا تبلیغات سیاسی اتحادیه اروپا (EU) را ارائه می دهد یا خیر. Display & Video 360 API و بارگذاری‌های SDF که اعلان‌ها را ارائه نمی‌کنند با شکست مواجه می‌شوند. برای جزئیات بیشتر در مورد نحوه به روز رسانی یکپارچه سازی خود برای ایجاد این اعلامیه، به
صفحه لغو اعتبار ما مراجعه کنید.
Method: guaranteedOrders.editGuaranteedOrderReadAccessors
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
آگهی‌دهندگان یک سفارش تضمین‌شده ویرایش‌ها خوانده می‌شوند.
درخواست HTTP
POST https://displayvideo.googleapis.com/v4/guaranteedOrders/{guaranteedOrderId}:editGuaranteedOrderReadAccessors
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
guaranteedOrderId | string مورد نیاز. شناسه سفارش تضمین شده برای ویرایش. شناسه از قالب {exchange}-{legacyGuaranteedOrderId} است |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"partnerId": string,
"readAccessInherited": boolean,
"addedAdvertisers": [
string
],
"removedAdvertisers": [
string
]
} |
| فیلدها |
|---|
partnerId | string ( int64 format) مورد نیاز. زمینه شریکی که در آن تغییر ایجاد می شود. |
readAccessInherited | boolean آیا به همه تبلیغ‌کنندگان شریک دسترسی خواندن/نوشتن به سفارش تضمین‌شده دسترسی خواندن داده شود. فقط در صورتی قابل اجرا است که readWritePartnerId به ترتیب تضمین شده تنظیم شده باشد. |
addedAdvertisers[] | string ( int64 format) تبلیغ کنندگان را به عنوان دسترسی های خواندنی به سفارش تضمین شده اضافه کنند. |
removedAdvertisers[] | string ( int64 format) تبلیغ کنندگان به عنوان خوانده شده دسترسی به سفارش تضمین شده را حذف کنید. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"readAccessInherited": boolean,
"readAdvertiserIds": [
string
]
} |
| فیلدها |
|---|
readAccessInherited | boolean آیا همه تبلیغ‌کنندگان readWritePartnerId به سفارش تضمین‌شده دسترسی خواندنی دارند یا خیر. |
readAdvertiserIds[] | string ( int64 format) شناسه آگهی دهندگان با دسترسی خواندنی به سفارش تضمین شده. |
محدوده مجوز
به محدوده 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 بهوقت ساعت هماهنگ جهانی."],[],["The Display & Video 360 API v4 beta allows editing read accessors for a guaranteed order via a POST request to a specific URL, using the guaranteed order ID. The request body, in JSON format, must contain the partner ID, and may include whether read access is inherited, advertisers to be added, and advertisers to be removed as read accessors. The successful response body indicates whether access is inherited and lists IDs of advertisers with read access. Authorization requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"],null,["# Method: guaranteedOrders.editGuaranteedOrderReadAccessors\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.EditGuaranteedOrderReadAccessorsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nEdits read advertisers of a guaranteed order.\n\n### HTTP request\n\n`POST https://displayvideo.googleapis.com/v4/guaranteedOrders/{guaranteedOrderId}:editGuaranteedOrderReadAccessors`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------------|---------------------------------------------------------------------------------------------------------------------------|\n| `guaranteedOrderId` | `string` Required. The ID of the guaranteed order to edit. The ID is of the format `{exchange}-{legacyGuaranteedOrderId}` |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"partnerId\": string, \"readAccessInherited\": boolean, \"addedAdvertisers\": [ string ], \"removedAdvertisers\": [ string ] } ``` |\n\n| Fields ||\n|------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The partner context in which the change is being made. |\n| `readAccessInherited` | `boolean` Whether to give all advertisers of the read/write accessor partner read access to the guaranteed order. Only applicable if [readWritePartnerId](/display-video/api/reference/rest/v4/guaranteedOrders#GuaranteedOrder.FIELDS.read_write_partner_id) is set in the guaranteed order. |\n| `addedAdvertisers[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The advertisers to add as read accessors to the guaranteed order. |\n| `removedAdvertisers[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The advertisers to remove as read accessors to the guaranteed order. |\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------|\n| ``` { \"readAccessInherited\": boolean, \"readAdvertiserIds\": [ string ] } ``` |\n\n| Fields ||\n|-----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `readAccessInherited` | `boolean` Whether all advertisers of [readWritePartnerId](/display-video/api/reference/rest/v4/guaranteedOrders#GuaranteedOrder.FIELDS.read_write_partner_id) have read access to the guaranteed order. |\n| `readAdvertiserIds[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The IDs of advertisers with read access to the guaranteed order. |\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)."]]
