API قبلی Search Ads 360 Reporting حذف می‌شود و در 30 ژوئن 2024 از رده خارج می‌شود. توجه داشته باشید که Search Ads 360 Conversion API تحت تأثیر قرار نگرفته و همچنان پشتیبانی می‌شود. همه توسعه گزارش‌های جدید باید از Search Ads 360 Reporting API جدید استفاده کنند.

از آوریل 2024، هنگام درخواست گزارش، یک خطای پشتیبانی‌نشده ApiVersion برگردانده می‌شود. جزئیات را اینجا ببینید.

همچنین اکیداً توصیه می‌کنیم که پیاده‌سازی‌های موجود Search Ads 360 را به API جدید منتقل کنید. برای اطلاعات بیشتر به راهنمای جدید Search Ads 360 Reporting Getting Started and Migration مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

API Reference

این مرجع API بر اساس نوع منبع سازماندهی شده است. هر نوع منبع دارای یک یا چند نمایش داده و یک یا چند روش است.

تبدیل

برای جزئیات منبع تبدیل، صفحه نمایش منبع را ببینید.

روش	درخواست HTTP	شرح
URI های مربوط به https://www.googleapis.com/doubleclicksearch/v2، مگر اینکه خلاف آن ذکر شده باشد
گرفتن	`GET /agency/ agencyId /advertiser/ advertiserId /engine/ engineAccountId /conversion`	فهرستی از تبدیل‌ها را از حساب موتور جستجوی DoubleClick بازیابی می‌کند. پارامترهای درخواست مورد نیاز: `endDate` ، `rowCount` ، `startDate` ، `startRow`
getByCustomerId	`GET /customer/ customerId /conversion`	فهرستی از تبدیل‌ها را از حساب موتور جستجوی DoubleClick با استفاده از شناسه مشتری Search Ads 360 جدید بازیابی می‌کند. پارامترهای درخواست مورد نیاز: `endDate` ، `rowCount` ، `startDate` ، `startRow`
درج کنید	`POST /conversion`	دسته ای از تبدیل های جدید را در DoubleClick Search درج می کند.
به روز رسانی	`PUT /conversion`	دسته ای از تبدیل ها را در جستجوی DoubleClick به روز می کند.
updateAvailability	`POST /conversion/updateAvailability`	در دسترس بودن دسته ای از فعالیت های نورافکن را در جستجوی DoubleClick به روز می کند.

گزارش ها

برای جزئیات منابع گزارش ها، صفحه نمایش منبع را ببینید.

روش	درخواست HTTP	شرح
URI های مربوط به https://www.googleapis.com/doubleclicksearch/v2، مگر اینکه خلاف آن ذکر شده باشد
تولید می کنند	`POST /reports/generate`	بلافاصله گزارشی را ایجاد و برمی گرداند.
گرفتن	`GET /reports/ reportId`	نظرسنجی برای وضعیت درخواست گزارش.
getFile	`GET /reports/ reportId /files/ reportFragment`	یک فایل گزارش کدگذاری شده در UTF-8 را دانلود می کند.
getIdMappingFile	`GET /agency/ agencyId /advertiser/ advertiserId /idmapping`	یک فایل CSV (کدگذاری‌شده در UTF-8) را دانلود می‌کند که حاوی نگاشت‌های شناسه بین Search Ads 360 قبلی و Search Ads 360 جدید است. برای تبلیغ‌کننده درخواست‌شده، این فایل شامل همه موجودیت‌های کودک (مانند حساب‌های موتور، کمپین‌ها، گروه‌های تبلیغاتی و غیره می‌شود). .) که هم در Search Ads 360 قبلی و هم در Search Ads 360 جدید وجود دارد.
درخواست	`POST /reports`	درخواست گزارش را در سیستم گزارش دهی درج می کند.

ستون های ذخیره شده

برای جزئیات منبع SavedColumns، صفحه نمایش منبع را ببینید.

روش	درخواست HTTP	شرح
URI های مربوط به https://www.googleapis.com/doubleclicksearch/v2، مگر اینکه خلاف آن ذکر شده باشد
فهرست	`GET /agency/ agencyId /advertiser/ advertiserId /savedcolumns`	لیست ستون های ذخیره شده را برای یک تبلیغ کننده مشخص بازیابی کنید.