Method: customers.searchAds360.search

همه ردیف‌هایی را که با عبارت جستجو مطابقت دارند برمی‌گرداند.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError داخلی خطا QueryError QuotaError RequestError

درخواست HTTP

POST https://searchads360.googleapis.com/v0/customers/{customerId}/searchAds360:search

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
customerId

string

مورد نیاز. شناسه مشتری مورد سوال

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "query": string,
  "pageToken": string,
  "pageSize": integer,
  "validateOnly": boolean,
  "returnTotalResultsCount": boolean,
  "summaryRowSetting": enum (SummaryRowSetting)
}
فیلدها
query

string

مورد نیاز. رشته پرس و جو.

pageToken

string

نشانه صفحه برای بازیابی. اگر مشخص نشده باشد، صفحه اول نتایج برگردانده خواهد شد. از مقدار بدست آمده از nextPageToken در پاسخ قبلی برای درخواست صفحه بعدی نتایج استفاده کنید.

pageSize

integer

تعداد عناصر برای بازیابی در یک صفحه هنگامی که یک صفحه خیلی بزرگ درخواست می شود، سرور ممکن است تصمیم بگیرد تعداد منابع برگشتی را بیشتر محدود کند.

validateOnly

boolean

اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود.

returnTotalResultsCount

boolean

اگر درست باشد، تعداد کل نتایجی که با پرس و جو مطابقت دارند و بند LIMIT را نادیده می گیرند، در پاسخ لحاظ می شود. پیش فرض نادرست است.

summaryRowSetting

enum ( SummaryRowSetting )

تعیین می کند که آیا یک ردیف خلاصه بازگردانده می شود یا خیر. به طور پیش فرض، ردیف خلاصه برگردانده نمی شود. در صورت درخواست، ردیف خلاصه پس از بازگرداندن سایر نتایج پرس و جو، خود به خود در پاسخ ارسال می شود.

بدن پاسخگو

پیام پاسخ برای SearchAds360Service.Search .

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "results": [
    {
      object (SearchAds360Row)
    }
  ],
  "nextPageToken": string,
  "totalResultsCount": string,
  "fieldMask": string,
  "summaryRow": {
    object (SearchAds360Row)
  },
  "customColumnHeaders": [
    {
      object (CustomColumnHeader)
    }
  ],
  "conversionCustomMetricHeaders": [
    {
      object (ConversionCustomMetricHeader)
    }
  ],
  "conversionCustomDimensionHeaders": [
    {
      object (ConversionCustomDimensionHeader)
    }
  ],
  "rawEventConversionMetricHeaders": [
    {
      object (RawEventConversionMetricHeader)
    }
  ],
  "rawEventConversionDimensionHeaders": [
    {
      object (RawEventConversionDimensionHeader)
    }
  ]
}
فیلدها
results[]

object ( SearchAds360Row )

لیست ردیف هایی که با پرس و جو مطابقت دارند.

nextPageToken

string

نشانه صفحه بندی برای بازیابی صفحه بعدی نتایج استفاده می شود. محتوای این رشته را به عنوان صفت pageToken درخواست بعدی ارسال کنید. nextPageToken برای صفحه آخر بازگردانده نمی شود.

totalResultsCount

string ( int64 format)

تعداد کل نتایجی که با پرس و جو مطابقت دارند و بند LIMIT را نادیده می گیرند.

fieldMask

string ( FieldMask format)

FieldMask که نشان می دهد چه فیلدهایی توسط کاربر درخواست شده است.

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

summaryRow

object ( SearchAds360Row )

ردیف خلاصه که شامل خلاصه معیارها در نتایج است. خلاصه معیارها به معنای تجمیع معیارها در همه نتایج است، در اینجا تجمیع می تواند مجموع، میانگین، نرخ و غیره باشد.

customColumnHeaders[]

object ( CustomColumnHeader )

سرصفحه های ستون های سفارشی در نتایج.

conversionCustomMetricHeaders[]

object ( ConversionCustomMetricHeader )

سرصفحه‌های معیارهای سفارشی تبدیل در نتایج.

conversionCustomDimensionHeaders[]

object ( ConversionCustomDimensionHeader )

هدر ابعاد سفارشی تبدیل در نتایج.

rawEventConversionMetricHeaders[]

object ( RawEventConversionMetricHeader )

سرصفحه های معیارهای تبدیل رویداد خام در نتایج.

rawEventConversionDimensionHeaders[]

object ( RawEventConversionDimensionHeader )

هدر ابعاد تبدیل رویداد خام در نتایج.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/doubleclicksearch
،

همه ردیف‌هایی را که با عبارت جستجو مطابقت دارند برمی‌گرداند.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError داخلی خطا QueryError QuotaError RequestError

درخواست HTTP

POST https://searchads360.googleapis.com/v0/customers/{customerId}/searchAds360:search

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
customerId

string

مورد نیاز. شناسه مشتری مورد سوال

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "query": string,
  "pageToken": string,
  "pageSize": integer,
  "validateOnly": boolean,
  "returnTotalResultsCount": boolean,
  "summaryRowSetting": enum (SummaryRowSetting)
}
فیلدها
query

string

مورد نیاز. رشته پرس و جو.

pageToken

string

نشانه صفحه برای بازیابی. اگر مشخص نشده باشد، صفحه اول نتایج برگردانده خواهد شد. از مقدار بدست آمده از nextPageToken در پاسخ قبلی برای درخواست صفحه بعدی نتایج استفاده کنید.

pageSize

integer

تعداد عناصر برای بازیابی در یک صفحه هنگامی که یک صفحه خیلی بزرگ درخواست می شود، سرور ممکن است تصمیم بگیرد تعداد منابع برگشتی را بیشتر محدود کند.

validateOnly

boolean

اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود.

returnTotalResultsCount

boolean

اگر درست باشد، تعداد کل نتایجی که با پرس و جو مطابقت دارند و بند LIMIT را نادیده می گیرند، در پاسخ لحاظ می شود. پیش فرض نادرست است.

summaryRowSetting

enum ( SummaryRowSetting )

تعیین می کند که آیا یک ردیف خلاصه بازگردانده می شود یا خیر. به طور پیش فرض، ردیف خلاصه برگردانده نمی شود. در صورت درخواست، ردیف خلاصه پس از بازگرداندن سایر نتایج پرس و جو، خود به خود در پاسخ ارسال می شود.

بدن پاسخگو

پیام پاسخ برای SearchAds360Service.Search .

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "results": [
    {
      object (SearchAds360Row)
    }
  ],
  "nextPageToken": string,
  "totalResultsCount": string,
  "fieldMask": string,
  "summaryRow": {
    object (SearchAds360Row)
  },
  "customColumnHeaders": [
    {
      object (CustomColumnHeader)
    }
  ],
  "conversionCustomMetricHeaders": [
    {
      object (ConversionCustomMetricHeader)
    }
  ],
  "conversionCustomDimensionHeaders": [
    {
      object (ConversionCustomDimensionHeader)
    }
  ],
  "rawEventConversionMetricHeaders": [
    {
      object (RawEventConversionMetricHeader)
    }
  ],
  "rawEventConversionDimensionHeaders": [
    {
      object (RawEventConversionDimensionHeader)
    }
  ]
}
فیلدها
results[]

object ( SearchAds360Row )

لیست ردیف هایی که با پرس و جو مطابقت دارند.

nextPageToken

string

نشانه صفحه بندی برای بازیابی صفحه بعدی نتایج استفاده می شود. محتوای این رشته را به عنوان صفت pageToken درخواست بعدی ارسال کنید. nextPageToken برای صفحه آخر بازگردانده نمی شود.

totalResultsCount

string ( int64 format)

تعداد کل نتایجی که با پرس و جو مطابقت دارند و بند LIMIT را نادیده می گیرند.

fieldMask

string ( FieldMask format)

FieldMask که نشان می دهد چه فیلدهایی توسط کاربر درخواست شده است.

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

summaryRow

object ( SearchAds360Row )

ردیف خلاصه که شامل خلاصه معیارها در نتایج است. خلاصه معیارها به معنای تجمیع معیارها در همه نتایج است، در اینجا تجمیع می تواند مجموع، میانگین، نرخ و غیره باشد.

customColumnHeaders[]

object ( CustomColumnHeader )

سرصفحه های ستون های سفارشی در نتایج.

conversionCustomMetricHeaders[]

object ( ConversionCustomMetricHeader )

سرصفحه‌های معیارهای سفارشی تبدیل در نتایج.

conversionCustomDimensionHeaders[]

object ( ConversionCustomDimensionHeader )

هدر ابعاد سفارشی تبدیل در نتایج.

rawEventConversionMetricHeaders[]

object ( RawEventConversionMetricHeader )

سرصفحه های معیارهای تبدیل رویداد خام در نتایج.

rawEventConversionDimensionHeaders[]

object ( RawEventConversionDimensionHeader )

هدر ابعاد تبدیل رویداد خام در نتایج.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/doubleclicksearch
،

همه ردیف‌هایی را که با عبارت جستجو مطابقت دارند برمی‌گرداند.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError داخلی خطا QueryError QuotaError RequestError

درخواست HTTP

POST https://searchads360.googleapis.com/v0/customers/{customerId}/searchAds360:search

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
customerId

string

مورد نیاز. شناسه مشتری مورد سوال

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "query": string,
  "pageToken": string,
  "pageSize": integer,
  "validateOnly": boolean,
  "returnTotalResultsCount": boolean,
  "summaryRowSetting": enum (SummaryRowSetting)
}
فیلدها
query

string

مورد نیاز. رشته پرس و جو.

pageToken

string

نشانه صفحه برای بازیابی. اگر مشخص نشده باشد، صفحه اول نتایج برگردانده خواهد شد. از مقدار بدست آمده از nextPageToken در پاسخ قبلی برای درخواست صفحه بعدی نتایج استفاده کنید.

pageSize

integer

تعداد عناصر برای بازیابی در یک صفحه هنگامی که یک صفحه خیلی بزرگ درخواست می شود، سرور ممکن است تصمیم بگیرد تعداد منابع برگشتی را بیشتر محدود کند.

validateOnly

boolean

اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود.

returnTotalResultsCount

boolean

اگر درست باشد، تعداد کل نتایجی که با پرس و جو مطابقت دارند و بند LIMIT را نادیده می گیرند، در پاسخ لحاظ می شود. پیش فرض نادرست است.

summaryRowSetting

enum ( SummaryRowSetting )

تعیین می کند که آیا یک ردیف خلاصه بازگردانده می شود یا خیر. به طور پیش فرض، ردیف خلاصه برگردانده نمی شود. در صورت درخواست، ردیف خلاصه پس از بازگرداندن سایر نتایج پرس و جو، خود به خود در پاسخ ارسال می شود.

بدن پاسخگو

پیام پاسخ برای SearchAds360Service.Search .

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "results": [
    {
      object (SearchAds360Row)
    }
  ],
  "nextPageToken": string,
  "totalResultsCount": string,
  "fieldMask": string,
  "summaryRow": {
    object (SearchAds360Row)
  },
  "customColumnHeaders": [
    {
      object (CustomColumnHeader)
    }
  ],
  "conversionCustomMetricHeaders": [
    {
      object (ConversionCustomMetricHeader)
    }
  ],
  "conversionCustomDimensionHeaders": [
    {
      object (ConversionCustomDimensionHeader)
    }
  ],
  "rawEventConversionMetricHeaders": [
    {
      object (RawEventConversionMetricHeader)
    }
  ],
  "rawEventConversionDimensionHeaders": [
    {
      object (RawEventConversionDimensionHeader)
    }
  ]
}
فیلدها
results[]

object ( SearchAds360Row )

لیست ردیف هایی که با پرس و جو مطابقت دارند.

nextPageToken

string

نشانه صفحه بندی برای بازیابی صفحه بعدی نتایج استفاده می شود. محتوای این رشته را به عنوان صفت pageToken درخواست بعدی ارسال کنید. nextPageToken برای صفحه آخر بازگردانده نمی شود.

totalResultsCount

string ( int64 format)

تعداد کل نتایجی که با پرس و جو مطابقت دارند و بند LIMIT را نادیده می گیرند.

fieldMask

string ( FieldMask format)

FieldMask که نشان می دهد چه فیلدهایی توسط کاربر درخواست شده است.

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

summaryRow

object ( SearchAds360Row )

ردیف خلاصه که شامل خلاصه معیارها در نتایج است. خلاصه معیارها به معنای تجمیع معیارها در همه نتایج است، در اینجا تجمیع می تواند مجموع، میانگین، نرخ و غیره باشد.

customColumnHeaders[]

object ( CustomColumnHeader )

سرصفحه های ستون های سفارشی در نتایج.

conversionCustomMetricHeaders[]

object ( ConversionCustomMetricHeader )

سرصفحه‌های معیارهای سفارشی تبدیل در نتایج.

conversionCustomDimensionHeaders[]

object ( ConversionCustomDimensionHeader )

هدر ابعاد سفارشی تبدیل در نتایج.

rawEventConversionMetricHeaders[]

object ( RawEventConversionMetricHeader )

سرصفحه های معیارهای تبدیل رویداد خام در نتایج.

rawEventConversionDimensionHeaders[]

object ( RawEventConversionDimensionHeader )

هدر ابعاد تبدیل رویداد خام در نتایج.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/doubleclicksearch
،

همه ردیف‌هایی را که با عبارت جستجو مطابقت دارند برمی‌گرداند.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError داخلی خطا QueryError QuotaError RequestError

درخواست HTTP

POST https://searchads360.googleapis.com/v0/customers/{customerId}/searchAds360:search

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
customerId

string

مورد نیاز. شناسه مشتری مورد سوال

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "query": string,
  "pageToken": string,
  "pageSize": integer,
  "validateOnly": boolean,
  "returnTotalResultsCount": boolean,
  "summaryRowSetting": enum (SummaryRowSetting)
}
فیلدها
query

string

مورد نیاز. رشته پرس و جو.

pageToken

string

نشانه صفحه برای بازیابی. اگر مشخص نشده باشد، صفحه اول نتایج برگردانده خواهد شد. از مقدار بدست آمده از nextPageToken در پاسخ قبلی برای درخواست صفحه بعدی نتایج استفاده کنید.

pageSize

integer

تعداد عناصر برای بازیابی در یک صفحه هنگامی که یک صفحه خیلی بزرگ درخواست می شود، سرور ممکن است تصمیم بگیرد تعداد منابع برگشتی را بیشتر محدود کند.

validateOnly

boolean

اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود.

returnTotalResultsCount

boolean

اگر درست باشد، تعداد کل نتایجی که با پرس و جو مطابقت دارند و بند LIMIT را نادیده می گیرند، در پاسخ لحاظ می شود. پیش فرض نادرست است.

summaryRowSetting

enum ( SummaryRowSetting )

تعیین می کند که آیا یک ردیف خلاصه بازگردانده می شود یا خیر. به طور پیش فرض، ردیف خلاصه برگردانده نمی شود. در صورت درخواست، ردیف خلاصه پس از بازگرداندن سایر نتایج پرس و جو، خود به خود در پاسخ ارسال می شود.

بدن پاسخگو

پیام پاسخ برای SearchAds360Service.Search .

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "results": [
    {
      object (SearchAds360Row)
    }
  ],
  "nextPageToken": string,
  "totalResultsCount": string,
  "fieldMask": string,
  "summaryRow": {
    object (SearchAds360Row)
  },
  "customColumnHeaders": [
    {
      object (CustomColumnHeader)
    }
  ],
  "conversionCustomMetricHeaders": [
    {
      object (ConversionCustomMetricHeader)
    }
  ],
  "conversionCustomDimensionHeaders": [
    {
      object (ConversionCustomDimensionHeader)
    }
  ],
  "rawEventConversionMetricHeaders": [
    {
      object (RawEventConversionMetricHeader)
    }
  ],
  "rawEventConversionDimensionHeaders": [
    {
      object (RawEventConversionDimensionHeader)
    }
  ]
}
فیلدها
results[]

object ( SearchAds360Row )

لیست ردیف هایی که با پرس و جو مطابقت دارند.

nextPageToken

string

نشانه صفحه بندی برای بازیابی صفحه بعدی نتایج استفاده می شود. محتوای این رشته را به عنوان صفت pageToken درخواست بعدی ارسال کنید. nextPageToken برای صفحه آخر بازگردانده نمی شود.

totalResultsCount

string ( int64 format)

تعداد کل نتایجی که با پرس و جو مطابقت دارند و بند LIMIT را نادیده می گیرند.

fieldMask

string ( FieldMask format)

FieldMask که نشان می دهد چه فیلدهایی توسط کاربر درخواست شده است.

این فهرستی از نام‌های فیلدهای کاملاً واجد شرایط با کاما است. مثال: "user.displayName,photo" .

summaryRow

object ( SearchAds360Row )

ردیف خلاصه که شامل خلاصه معیارها در نتایج است. خلاصه معیارها به معنای تجمیع معیارها در همه نتایج است، در اینجا تجمیع می تواند مجموع، میانگین، نرخ و غیره باشد.

customColumnHeaders[]

object ( CustomColumnHeader )

سرصفحه های ستون های سفارشی در نتایج.

conversionCustomMetricHeaders[]

object ( ConversionCustomMetricHeader )

سرصفحه‌های معیارهای سفارشی تبدیل در نتایج.

conversionCustomDimensionHeaders[]

object ( ConversionCustomDimensionHeader )

هدر ابعاد سفارشی تبدیل در نتایج.

rawEventConversionMetricHeaders[]

object ( RawEventConversionMetricHeader )

سرصفحه های معیارهای تبدیل رویداد خام در نتایج.

rawEventConversionDimensionHeaders[]

object ( RawEventConversionDimensionHeader )

هدر ابعاد تبدیل رویداد خام در نتایج.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/doubleclicksearch