Conversion: updateAvailability
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
อัปเดตความพร้อมใช้งานของกลุ่มกิจกรรม Floodlight ใน DoubleClick Search
ลองใช้เลย
ส่งคำขอ
คำขอ HTTP
POST https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
การให้สิทธิ์
คำขอนี้ต้องได้รับการให้สิทธิ์ตามขอบเขตต่อไปนี้
ขอบเขต |
https://www.googleapis.com/auth/doubleclicksearch |
สำหรับข้อมูลเพิ่มเติม โปรดดูที่หน้าการตรวจสอบสิทธิ์และการให้สิทธิ์
เนื้อหาของคำขอ
ในเนื้อหาคำขอ ให้ข้อมูลในโครงสร้างต่อไปนี้
{
"availabilities": [
{
"agencyId": long,
"advertiserId": long,
"customerId": string,
"segmentationType": string,
"segmentationId": long,
"segmentationName": string,
"availabilityTimestamp": unsigned long
}
]
}
ชื่อพร็อพเพอร์ตี้ |
ค่า |
คำอธิบาย |
หมายเหตุ |
availabilities[] |
list |
ความพร้อมที่กำลังขอ |
|
availabilities[].agencyId |
long |
รหัสเอเจนซี DS |
|
availabilities[].advertiserId |
long |
รหัสผู้ลงโฆษณา DS |
|
availabilities[].segmentationType |
string |
ประเภทการแบ่งกลุ่มซึ่งใช้สำหรับความพร้อมใช้งานนี้ได้ (ค่าเริ่มต้นคือ FLOODLIGHT )
ค่าที่ยอมรับได้ มีดังนี้
|
|
availabilities[].segmentationId |
long |
ตัวระบุการแบ่งกลุ่มที่เป็นตัวเลข (เช่น รหัสกิจกรรม DoubleClick Search Floodlight) |
|
availabilities[].segmentationName |
string |
ตัวระบุการแบ่งกลุ่มลูกค้าที่ใช้งานง่าย (เช่น ชื่อกิจกรรม DoubleClick Search Floodlight) |
|
availabilities[].availabilityTimestamp |
unsigned long |
เวลาที่อัปโหลด Conversion ทั้งหมด เป็น Epoch millis UTC |
|
availabilities[].customerId |
string |
รหัสลูกค้า Search Ads 360 เวอร์ชันใหม่ ต้องเป็นบัญชีดูแลจัดการย่อย |
|
คำตอบ
หากทำสำเร็จ เมธอดนี้จะแสดงเนื้อหาการตอบกลับพร้อมโครงสร้างต่อไปนี้
{
"availabilities": [
{
"agencyId": long,
"advertiserId": long,
"customerId": string,
"segmentationType": string,
"segmentationId": long,
"segmentationName": string,
"availabilityTimestamp": unsigned long
}
]
}
ชื่อพร็อพเพอร์ตี้ |
ค่า |
คำอธิบาย |
หมายเหตุ |
availabilities[] |
list |
ความพร้อมที่กำลังส่งคืน |
|
availabilities[].agencyId |
long |
รหัสเอเจนซี DS |
|
availabilities[].advertiserId |
long |
รหัสผู้ลงโฆษณา DS |
|
availabilities[].segmentationType |
string |
ประเภทการแบ่งกลุ่มซึ่งใช้สำหรับความพร้อมใช้งานนี้ได้ (ค่าเริ่มต้นคือ FLOODLIGHT )
ค่าที่ยอมรับได้ มีดังนี้
|
|
availabilities[].segmentationId |
long |
ตัวระบุการแบ่งกลุ่มที่เป็นตัวเลข (เช่น รหัสกิจกรรม DoubleClick Search Floodlight) |
|
availabilities[].segmentationName |
string |
ตัวระบุการแบ่งกลุ่มลูกค้าที่ใช้งานง่าย (เช่น ชื่อกิจกรรม DoubleClick Search Floodlight) |
|
availabilities[].availabilityTimestamp |
unsigned long |
เวลาที่อัปโหลด Conversion ทั้งหมด เป็น Epoch millis UTC |
|
availabilities[].customerId |
string |
รหัสลูกค้า Search Ads 360 เวอร์ชันใหม่ ต้องเป็นบัญชีดูแลจัดการย่อย |
|
ลองใช้งาน
ใช้ API Explorer ด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลแบบสดและดูการตอบกลับ
หรือจะลองใช้
สแตนด์อโลน
สำรวจ
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2024-08-20 UTC
[null,null,["อัปเดตล่าสุด 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)."]]