REST Resource: customers.analysisQueries

منبع: AnalysisQuery

یک کوئری تحلیلی را تعریف می کند که می تواند در Ads Data Hub اجرا شود.

نمایندگی JSON
{
  "name": string,
  "title": string,
  "queryText": string,
  "parameterTypes": {
    string: {
      object (ParameterType)
    },
    ...
  },
  "mergeSpec": {
    object (MergeSpec)
  },
  "queryState": enum (QueryState),
  "updateTime": string,
  "updateEmail": string,
  "createTime": string,
  "createEmail": string,
  "queryShare": [
    {
      object (QueryShare)
    }
  ],

  // Union field filtered_row can be only one of the following:
  "filteredRowSummary": {
    object (FilteredRowSummary)
  },
  "generateFilteredRowSummaryAutomatically": boolean
  // End of list of possible types for union field filtered_row.
}
زمینه های
name

string

نامی که به طور منحصر به فرد یک پرس و جو را شناسایی می کند. این فرم مشتریان/[customerId]/analysisQueries/[resource_id] است، به عنوان مثال 'customers/123/analysisQueries/abcd1234'. شناسه منبع توسط سرور تولید می شود.

title

string

عنوان پرس و جو، که در یک مشتری Ads Data Hub و نوع درخواست منحصر به فرد است.

queryText

string

متن پرس و جو نوشته شده در استاندارد SQL. به https://cloud.google.com/bigquery/docs/reference/standard-sql/ مراجعه کنید.

parameterTypes

map (key: string, value: object ( ParameterType ))

هر پارامتر اضافی مورد انتظار پرس و جو. نام هر آرگومان را به نوع آرگومان آن نگاشت می کند.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

mergeSpec
(deprecated)

object ( MergeSpec )

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

queryState

enum ( QueryState )

وضعیت پرس و جو

updateTime

string ( Timestamp format)

زمان آخرین به روز رسانی پرس و جو

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

updateEmail

string

آدرس ایمیل کاربری که آخرین بار درخواست را به روز کرده است.

createTime

string ( Timestamp format)

زمان ایجاد پرس و جو

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

createEmail

string

آدرس ایمیل کاربری که پرس و جو را ایجاد کرده است.

queryShare[]

object ( QueryShare )

راه‌هایی را نشان می‌دهد که ممکن است درخواستی فراتر از مالک Ads Data Hub به اشتراک گذاشته شود.

فیلد اتحادیه filtered_row . دستورالعمل ادغام ردیف. filtered_row فقط می تواند یکی از موارد زیر باشد:
filteredRowSummary

object ( FilteredRowSummary )

نحوه ترکیب ردیف هایی که به دلایل حفظ حریم خصوصی حذف شده اند را در یک ردیف ادغام شده تعریف کنید. اگر ردیف ادغام شده الزامات حریم خصوصی را برآورده کند، ردیف ادغام شده در خروجی نهایی گنجانده می شود.

generateFilteredRowSummaryAutomatically

boolean

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

MergeSpec

ادغام دستورالعمل ها برای طرح نتیجه پرس و جو تجزیه و تحلیل.

نمایندگی JSON
{
  "columns": {
    string: {
      object (MergeColumn)
    },
    ...
  }
}
زمینه های
columns

map (key: string, value: object ( MergeColumn ))

دستورالعمل ادغام هر ستون، با نام کلید شده است. هر ستون از دست رفته به عنوان MERGE_TYPE_UNSPECIFIED تلقی می شود.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

MergeColumn

دستورالعمل‌ها را برای یک ستون خروجی ادغام کنید.

نمایندگی JSON
{
  "type": enum (MergeType),
  "value": {
    object (ParameterValue)
  }
}
زمینه های
type

enum ( MergeType )

روش مورد استفاده برای ترکیب مقادیر ستون.

value

object ( ParameterValue )

مقدار ثابت برای استفاده (فقط برای نوع ادغام CONSTANT معتبر است).

MergeType

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

Enums
MERGE_TYPE_UNSPECIFIED نوع ادغام نامشخص مقدار ستون ادغام شده NULL خواهد بود.
CONSTANT مقدار ستون ادغام شده را با ثابت داده شده جایگزین کنید.
SUM مجموع مقادیر ستون ادغام شده را بگیرید.

FilteredRowSummary

ادغام دستورالعمل ها برای طرح نتیجه پرس و جو تجزیه و تحلیل.

نمایندگی JSON
{
  "columns": {
    string: {
      object (ColumnSummaryRule)
    },
    ...
  }
}
زمینه های
columns

map (key: string, value: object ( ColumnSummaryRule ))

دستورالعمل ادغام هر ستون، با نام کلید شده است. هر ستون از دست رفته به عنوان SUMMARY_TYPE_UNSPECIFIED تلقی خواهد شد.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

ColumnSummaryRule

دستورالعمل‌ها را برای یک ستون خروجی ادغام کنید.

نمایندگی JSON
{
  "type": enum (SummaryType),
  "value": {
    object (ParameterValue)
  }
}
زمینه های
type

enum ( SummaryType )

روش مورد استفاده برای ترکیب مقادیر ستون.

value

object ( ParameterValue )

مقدار ثابت برای استفاده (فقط برای نوع خلاصه CONSTANT معتبر است).

نوع خلاصه

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

Enums
SUMMARY_TYPE_UNSPECIFIED نوع خلاصه نامشخص مقدار ستون خلاصه NULL خواهد بود.
CONSTANT مقدار ستون ادغام شده را با ثابت داده شده جایگزین کنید.
SUM مجموع مقادیر ستون ادغام شده را بگیرید.

مواد و روش ها

create

 یک کوئری تحلیلی برای اجرای بعدی ایجاد می کند.

delete

 یک جستار تجزیه و تحلیل را حذف می کند.

get

 پرسش تحلیل درخواستی را بازیابی می کند.

list

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

patch

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

start

 اجرا را روی یک کوئری تحلیلی ذخیره شده شروع می کند.

startTransient

 اجرا را روی یک کوئری تحلیل گذرا شروع می کند.

validate

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