Conversion: updateAvailability

در دسترس بودن دسته ای از فعالیت های نورافکن را در جستجوی DoubleClick به روز می کند. اکنون آن را امتحان کنید .

درخواست کنید

درخواست 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 است).

مقادیر قابل قبول عبارتند از:
  • " FLOODLIGHT "
availabilities[]. segmentationId long شناسه تقسیم بندی عددی (به عنوان مثال شناسه فعالیت DoubleClick Search Floodlight).
availabilities[]. segmentationName string شناسه تقسیم بندی دوستانه (به عنوان مثال، نام فعالیت DoubleClick Search Floodlight).
availabilities[]. availabilityTimestamp unsigned long زمانی که تا آن زمان همه تبدیل‌ها آپلود شده‌اند، در 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 است).

مقادیر قابل قبول عبارتند از:
  • " FLOODLIGHT "
availabilities[]. segmentationId long شناسه تقسیم بندی عددی (به عنوان مثال شناسه فعالیت DoubleClick Search Floodlight).
availabilities[]. segmentationName string شناسه تقسیم بندی دوستانه (به عنوان مثال، نام فعالیت DoubleClick Search Floodlight).
availabilities[]. availabilityTimestamp unsigned long زمانی که تا آن زمان همه تبدیل‌ها آپلود شده‌اند، در Epoch millis UTC.
availabilities[]. customerId string شناسه مشتری جدید Search Ads 360. این باید یک حساب کاربری فرعی باشد.

آن را امتحان کنید!

از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید. از طرف دیگر، اکسپلورر مستقل را امتحان کنید.