8 Eylül 2025'ten itibaren her yeni satır öğesinin, Avrupa Birliği (AB) siyasi reklamları yayınlayıp yayınlamayacağını beyan etmesi gerekecek. Bildirim içermeyen Display & Video 360 API ve SDF yüklemeleri başarısız olur. Entegrasyonunuzu bu beyanı yapacak şekilde güncelleme hakkında daha fazla bilgi için
desteği sonlandırma sayfamıza bakın.
Method: guaranteedOrders.patch
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Mevcut bir garantili siparişi günceller. İşlem başarılı olursa güncellenmiş garantili siparişi döndürür.
HTTP isteği
PATCH https://displayvideo.googleapis.com/v4/guaranteedOrders/{guaranteedOrder.guaranteedOrderId}
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
| Parametreler |
guaranteedOrder.guaranteedOrderId |
string
Yalnızca çıkış. Garantili siparişin benzersiz tanımlayıcısıdır. Garanti edilen sipariş kimlikleri {exchange}-{legacyGuaranteedOrderId} biçimindedir.
|
Sorgu parametreleri
| Parametreler |
updateMask |
string (FieldMask format)
Zorunlu. Hangi alanların güncelleneceğini kontrol eden maske. Bu, alanların tam nitelikli adlarının virgülle ayrılmış bir listesidir. Örnek: "user.displayName,photo".
|
Birleştirme parametresi accessor. Zorunlu. İsteğin hangi DV360 öğesinde yapıldığını tanımlar. accessor yalnızca aşağıdakilerden biri olabilir: |
partnerId |
string (int64 format)
İsteğin gönderildiği iş ortağının kimliği.
|
advertiserId |
string (int64 format)
İsteğin yapıldığı reklamverenin kimliği.
|
İstek içeriği
İstek metni, GuaranteedOrder öğesinin bir örneğini içerir.
Yanıt gövdesi
Başarılıysa yanıt metni, GuaranteedOrder öğesinin bir örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/display-video
Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[],["The Display & Video 360 API v4 (beta) allows updating existing guaranteed orders via a PATCH request. The request URL includes the guaranteed order ID as a path parameter. Required query parameters include `updateMask`, to specify fields for updating, and an `accessor` (`partnerId` or `advertiserId`). The request and response bodies use the `GuaranteedOrder` format. The API uses gRPC Transcoding, and requires OAuth scope `https://www.googleapis.com/auth/display-video`. The request returns the updated guaranteed order upon success.\n"],null,["# Method: guaranteedOrders.patch\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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates an existing guaranteed order. Returns the updated guaranteed order if successful.\n\n### HTTP request\n\n`PATCH https://displayvideo.googleapis.com/v4/guaranteedOrders/{guaranteedOrder.guaranteedOrderId}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `guaranteedOrder.guaranteedOrderId` | `string` Output only. The unique identifier of the guaranteed order. The guaranteed order IDs have the format `{exchange}-{legacyGuaranteedOrderId}`. |\n\n### Query parameters\n\n| Parameters ||\n|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Required. The mask to control which fields to update. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n| Union parameter `accessor`. Required. Identifies which DV360 entity the request is being made within. `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 the request is being made within. |\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that the request is being made within. |\n\n### Request body\n\nThe request body contains an instance of [GuaranteedOrder](/display-video/api/reference/rest/v4/guaranteedOrders#GuaranteedOrder).\n\n### Response body\n\nIf successful, the response body contains an instance of [GuaranteedOrder](/display-video/api/reference/rest/v4/guaranteedOrders#GuaranteedOrder).\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)."]]
