Method: customers.userListQueries.validate

بررسی های اعتبارسنجی ایستا را در پرس و جو لیست کاربر ارائه شده انجام می دهد.

درخواست HTTP

POST https://adsdatahub.googleapis.com/v1/{parent=customers/*}/userListQueries:validate

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

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

مولفه های
parent

string

نام منبع والد مالک پرس و جو، به عنوان مثال «customers/123».

درخواست بدن

بدنه درخواست شامل داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "query": {
    object (UserListQuery)
  },
  "adsDataCustomerId": string,
  "matchDataCustomerId": string,
  "spec": {
    object (QueryExecutionSpec)
  },
  "includePerformanceInfo": boolean
}
زمینه های
query

object ( UserListQuery )

پرس و جو برای اعتبار سنجی

adsDataCustomerId
(deprecated)

string ( int64 format)

اختیاری. شناسه مشتری Ads Data Hub پیوندی خاص برای اعتبارسنجی داده‌های تبلیغات و دسترسی به جدول موقت. پیش‌فرض برای همه مشتریان مرتبط. منسوخ. از adsDataCustomerId داخل query_execution_spec استفاده کنید.

matchDataCustomerId
(deprecated)

string ( int64 format)

اختیاری. شناسه مشتری Ads Data Hub پیوندی خاص برای اعتبارسنجی داده‌های مطابقت و دسترسی به جدول موقت. پیش‌فرض برای همه مشتریان مرتبط. منسوخ. از match_table_customer_id داخل query_execution_spec استفاده کنید.

spec

object ( QueryExecutionSpec )

اختیاری. فیلدهای تکراری داخل query_execution_spec فیلدهای خارج را لغو می کنند.

includePerformanceInfo

boolean

اختیاری. اگر درست است، با BigQuery تماس بگیرید تا پرس و جو را خشک کند تا اطلاعات عملکرد جمع آوری شود. ممکن است در مقایسه با اعتبارسنجی پرس و جو بیشتر طول بکشد. startDate، endDate و پارامترهای داخل query_execution_spec باید برای اجرای خشک تنظیم شوند.

بدن پاسخگو

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

پاسخ به یک درخواست userListQueries.validate.

نمایندگی JSON
{
  "processedBytes": string,
  "queryPerformanceInfo": {
    object (QueryPerformanceInfo)
  }
}
زمینه های
processedBytes
(deprecated)

string ( int64 format)

منسوخ شده است و به جای آن از queryPerformanceInfo استفاده کنید. بایت های داده ای که این پرس و جو می خواند. برای جزئیات نحوه محاسبه به https://cloud.google.com/bigquery/pricing#data مراجعه کنید. اگر includePerformanceInfo درست باشد، برگردانده می شود. ProcessedBytes را به مگابایت گرد می کنیم و سپس آن را به بایت تبدیل می کنیم. -1 به این معنی است که ما نتوانستیم آن را برای این جستار واکشی کنیم.

queryPerformanceInfo

object ( QueryPerformanceInfo )

اگر includePerformanceInfo درست باشد، برگردانده می شود.

محدوده مجوز

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

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