Önceki Search Ads 360 Reporting API kullanımdan kaldırıldı. Artık yeni Search Ads 360 Reporting API'yi kullanarak raporlarınızı oluşturabilirsiniz.
Search Ads 360 Conversion API'deki get ve getByCustomerId yöntemlerinin desteğinin 2025'in 3. çeyreğinde sonlandırılacağını unutmayın. Dönüşüm verilerine erişmeye devam etmek için yeni Search Ads 360 Reporting API'yi kullanarak dönüşüm kaynağını kullanarak bir rapor oluşturmanız gerekir. Daha fazla ayrıntıyı burada bulabilirsiniz.
Diğer Search Ads 360 Conversion API işlevleri desteklenmeye devam edecektir.
Conversion: updateAvailability
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
DoubleClick Search'teki bir Floodlight etkinliği grubu grubunun kullanılabilirlik durumunu günceller.
Şimdi deneyin.
İstek
HTTP isteği
POST https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
Yetkilendirme
Bu istek, aşağıdaki kapsamla yetkilendirme gerektiriyor:
| Kapsam |
|---|
https://www.googleapis.com/auth/doubleclicksearch |
Daha fazla bilgi edinmek için kimlik doğrulama ve yetkilendirme sayfasına göz atın.
İstek içeriği
İstek gövdesinde, verileri aşağıdaki yapıyla sağlayın:
{
"availabilities": [
{
"agencyId": long,
"advertiserId": long,
"customerId": string,
"segmentationType": string,
"segmentationId": long,
"segmentationName": string,
"availabilityTimestamp": unsigned long
}
]
}
| Mülk adı |
Değer |
Açıklama |
Notlar |
availabilities[] |
list |
İstenen müsaitlik durumu. |
|
availabilities[].agencyId |
long |
DS ajans kimliği. |
|
availabilities[].advertiserId |
long |
DS reklamveren kimliği. |
|
availabilities[].segmentationType |
string |
Bu kullanılabilirliğin kullanıldığı segmentasyon türü (varsayılan değeri FLOODLIGHT'tır).
Kabul edilebilir değerler şunlardır:
|
|
availabilities[].segmentationId |
long |
Sayısal segmentasyon tanımlayıcısı (örneğin, DoubleClick Search Floodlight etkinlik kimliği). |
|
availabilities[].segmentationName |
string |
Uygun segmentasyon tanımlayıcısı (örneğin, DoubleClick Search Floodlight etkinlik adı). |
|
availabilities[].availabilityTimestamp |
unsigned long |
Tüm dönüşümlerin yüklenme zamanı (milisaniye cinsinden UTC saat diliminde). |
|
availabilities[].customerId |
string |
Yeni Search Ads 360 müşteri kimliği. Bu bir alt yönetici hesabı olmalıdır. |
|
Yanıt
Başarılı olursa bu yöntem, aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:
{
"availabilities": [
{
"agencyId": long,
"advertiserId": long,
"customerId": string,
"segmentationType": string,
"segmentationId": long,
"segmentationName": string,
"availabilityTimestamp": unsigned long
}
]
}
| Mülk adı |
Değer |
Açıklama |
Notlar |
availabilities[] |
list |
Döndürülen stok durumları. |
|
availabilities[].agencyId |
long |
DS ajans kimliği. |
|
availabilities[].advertiserId |
long |
DS reklamveren kimliği. |
|
availabilities[].segmentationType |
string |
Bu kullanılabilirliğin kullanıldığı segmentasyon türü (varsayılan değeri FLOODLIGHT'tır).
Kabul edilebilir değerler şunlardır:
|
|
availabilities[].segmentationId |
long |
Sayısal segmentasyon tanımlayıcısı (örneğin, DoubleClick Search Floodlight etkinlik kimliği). |
|
availabilities[].segmentationName |
string |
Uygun segmentasyon tanımlayıcısı (örneğin, DoubleClick Search Floodlight etkinlik adı). |
|
availabilities[].availabilityTimestamp |
unsigned long |
Tüm dönüşümlerin yüklenme zamanı (milisaniye cinsinden UTC saat diliminde). |
|
availabilities[].customerId |
string |
Yeni Search Ads 360 müşteri kimliği. Bu bir alt yönetici hesabı olmalıdır. |
|
Deneyin!
Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.
Alternatif olarak şunu da deneyebilirsiniz:
bağımsız
öğrenin.
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: 2024-08-20 UTC.
[null,null,["Son güncelleme tarihi: 2024-08-20 UTC."],[[["\u003cp\u003eUpdates the availability status for a batch of floodlight activities in DoubleClick Search.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclicksearch\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe request body includes an array of \u003ccode\u003eavailabilities\u003c/code\u003e with details like agencyId, advertiserId, segmentation details, and availability timestamp.\u003c/p\u003e\n"],["\u003cp\u003eThe response returns an array of \u003ccode\u003eavailabilities\u003c/code\u003e mirroring the request structure, confirming the updated status.\u003c/p\u003e\n"]]],["This API endpoint, accessed via a POST request to `https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability`, updates the availabilities of multiple floodlight activities in DoubleClick Search. The request body requires authorization and includes a list of `availabilities`. Each entry needs `agencyId`, `advertiserId`, `customerId`, `segmentationType` (default `FLOODLIGHT`), `segmentationId`, `segmentationName`, and `availabilityTimestamp`. The response mirrors the request structure, returning the updated `availabilities` with the same fields.\n"],null,["# Conversion: updateAvailability\n\n| **Note:** Requires [authorization](#auth).\n\nUpdates the availabilities of a batch of floodlight activities in DoubleClick Search.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability\n```\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/doubleclicksearch` |\n\nFor more information, see the [authentication and authorization](/search-ads/v2/authorizing) page.\n\n### Request body\n\nIn the request body, supply data with the following structure:\n\n```text\n{\n \"availabilities\": [\n {\n \"agencyId\": long,\n \"advertiserId\": long,\n \"customerId\": string,\n \"segmentationType\": string,\n \"segmentationId\": long,\n \"segmentationName\": string,\n \"availabilityTimestamp\": unsigned long\n }\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|------------------------------------------|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `availabilities[]` | `list` | The availabilities being requested. | |\n| availabilities[].`agencyId` | `long` | DS agency ID. | |\n| availabilities[].`advertiserId` | `long` | DS advertiser ID. | |\n| availabilities[].`segmentationType` | `string` | The segmentation type that this availability is for (its default value is `FLOODLIGHT`). \u003cbr /\u003e Acceptable values are: - \"`FLOODLIGHT`\" | |\n| availabilities[].`segmentationId` | `long` | The numeric segmentation identifier (for example, DoubleClick Search Floodlight activity ID). | |\n| availabilities[].`segmentationName` | `string` | The friendly segmentation identifier (for example, DoubleClick Search Floodlight activity name). | |\n| availabilities[].`availabilityTimestamp` | `unsigned long` | The time by which all conversions have been uploaded, in epoch millis UTC. | |\n| availabilities[].`customerId` | `string` | New Search Ads 360 customer ID. This must be a sub-manager account. | |\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"availabilities\": [\n {\n \"agencyId\": long,\n \"advertiserId\": long,\n \"customerId\": string,\n \"segmentationType\": string,\n \"segmentationId\": long,\n \"segmentationName\": string,\n \"availabilityTimestamp\": unsigned long\n }\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|------------------------------------------|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `availabilities[]` | `list` | The availabilities being returned. | |\n| availabilities[].`agencyId` | `long` | DS agency ID. | |\n| availabilities[].`advertiserId` | `long` | DS advertiser ID. | |\n| availabilities[].`segmentationType` | `string` | The segmentation type that this availability is for (its default value is `FLOODLIGHT`). \u003cbr /\u003e Acceptable values are: - \"`FLOODLIGHT`\" | |\n| availabilities[].`segmentationId` | `long` | The numeric segmentation identifier (for example, DoubleClick Search Floodlight activity ID). | |\n| availabilities[].`segmentationName` | `string` | The friendly segmentation identifier (for example, DoubleClick Search Floodlight activity name). | |\n| availabilities[].`availabilityTimestamp` | `unsigned long` | The time by which all conversions have been uploaded, in epoch millis UTC. | |\n| availabilities[].`customerId` | `string` | New Search Ads 360 customer ID. This must be a sub-manager account. | |\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/doubleclicksearch/v2/doubleclicksearch.conversion.updateAvailability)."]]
