API جدید Search Ads 360 Reporting اکنون در دسترس است. به گروه Google searchads-api-announcements بپیوندید تا در مورد پیشرفت‌ها و نسخه‌های آینده به‌روز باشید.
نشانه صفحه برای بازیابی. اگر مشخص نشده باشد، صفحه اول نتایج برگردانده خواهد شد. از مقدار بدست آمده از nextPageToken در پاسخ قبلی برای درخواست صفحه بعدی نتایج استفاده کنید.
pageSize
integer
تعداد عناصر برای بازیابی در یک صفحه هنگامی که یک صفحه خیلی بزرگ درخواست می شود، سرور ممکن است تصمیم بگیرد تعداد منابع برگشتی را بیشتر محدود کند.
validateOnly
boolean
اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود.
returnTotalResultsCount
boolean
اگر درست باشد، تعداد کل نتایجی که با پرس و جو مطابقت دارند و بند LIMIT را نادیده می گیرند، در پاسخ لحاظ می شود. پیش فرض نادرست است.
تعیین می کند که آیا یک ردیف خلاصه بازگردانده می شود یا خیر. به طور پیش فرض، ردیف خلاصه برگردانده نمی شود. در صورت درخواست، ردیف خلاصه پس از بازگرداندن سایر نتایج پرس و جو، خود به خود در پاسخ ارسال می شود.
نشانه صفحه بندی برای بازیابی صفحه بعدی نتایج استفاده می شود. محتوای این رشته را به عنوان صفت pageToken درخواست بعدی ارسال کنید. nextPageToken برای صفحه آخر بازگردانده نمی شود.
ردیف خلاصه که شامل خلاصه معیارها در نتایج است. خلاصه معیارها به معنای تجمیع معیارها در همه نتایج است، در اینجا تجمیع می تواند مجموع، میانگین، نرخ و غیره باشد.
تاریخ آخرین بهروزرسانی 2025-04-02 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-04-02 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eReturns all rows matching the provided search query, using the SearchAds360 service.\u003c/p\u003e\n"],["\u003cp\u003eRequires a POST request to the specified endpoint, including a \u003ccode\u003ecustomerId\u003c/code\u003e in the path.\u003c/p\u003e\n"],["\u003cp\u003eThe request body allows defining the query, pagination, validation, result count, and summary row settings.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes matching rows, pagination details, total results, field mask, and headers for custom and conversion columns.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclicksearch\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This describes the `search` method, which retrieves rows matching a query from Search Ads 360. The `POST` request to `searchAds360:search` requires a customer ID in the path. The request body includes a mandatory query string, optional pagination parameters (`pageToken`, `pageSize`), and options for validation and summary row inclusion. The response contains matching rows, potential pagination tokens, and total result counts. Error handling includes authentication, authorization, and quota related errors, among others. OAuth scope `doubleclicksearch` is required.\n"],null,[]]
