REST Resource: customers.analysisQueries

المورد: QueryQuery

تحديد طلب تحليل يمكن تنفيذه في 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]/analysisQuries/[resource_id]، مثل 'customers/123/analysisQuries/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

وفي حال ضبطها على "صحيح"، يتم إنشاء ملخّص للصفوف التي تمت فلترتها تلقائيًا.

مواصفات الدمج

دمج التعليمات لمخطّط نتائج طلب البحث للتحليل

تمثيل JSON 
{
  "columns": {
    string: {
      object (MergeColumn)
    },
    ...
  }
}
الحقول
columns

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

تعليمات دمج كل عمود، حسب المفتاح. سيتم التعامل مع أي أعمدة مفقودة على أنها MERGE_TYPE_UNSPECIFIED.

عنصر يحتوي على قائمة بأزواج "key": value. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

دمج العمود

دمج التعليمات لعمود إخراج واحد.

تمثيل JSON 
{
  "type": enum (MergeType),
  "value": {
    object (ParameterValue)
  }
}
الحقول
type

enum (MergeType)

الطريقة المستخدَمة لدمج قيم العمود.
value

object (ParameterValue)

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

نوع الدمج

كل العمليات المتوافقة مع دمج الأعمدة.

عمليات التعداد
MERGE_TYPE_UNSPECIFIED نوع دمج غير محدَّد. وستكون قيمة العمود المدمجة NULL.
CONSTANT استبدل قيمة العمود المدمجة بالثابت المحدد.
SUM اجمع مجموع قيم العمود المدمجة.

ملخص الصفوف التي تمت فلترتها

دمج التعليمات لمخطّط نتائج طلب البحث للتحليل

تمثيل JSON 
{
  "columns": {
    string: {
      object (ColumnSummaryRule)
    },
    ...
  }
}
الحقول
columns

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

تعليمات دمج كل عمود، حسب المفتاح. سيتم التعامل مع أي أعمدة مفقودة على أنها SUMMARY_TYPE_UNSPECIFIED.

عنصر يحتوي على قائمة بأزواج "key": value. مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

قاعدة الملخص على العمود

دمج التعليمات لعمود إخراج واحد.

تمثيل JSON 
{
  "type": enum (SummaryType),
  "value": {
    object (ParameterValue)
  }
}
الحقول
type

enum (SummaryType)

الطريقة المستخدَمة لدمج قيم العمود.
value

object (ParameterValue)

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

نوع الملخّص

كل العمليات المتوافقة مع دمج الأعمدة.

عمليات التعداد
SUMMARY_TYPE_UNSPECIFIED نوع ملخّص غير محدّد. وستكون قيمة عمود الملخص فارغة.
CONSTANT استبدل قيمة العمود المدمجة بالثابت المحدد.
SUM اجمع مجموع قيم العمود المدمجة.

الطُرق

create

 تنشئ طلب بحث لتنفيذه لاحقًا.

delete

 يؤدي هذا الإجراء إلى حذف طلب تحليل.

get

 لاسترداد طلب البحث المطلوب للتحليل.

list

 يسرد طلبات البحث التي يملكها العميل المحدّد.

patch

 يتم تعديل طلب بحث حالي.

start

 يبدأ التنفيذ على طلب تحليل مُخزَّن.

startTransient

 يبدأ التنفيذ في طلب تحليل مؤقت.

validate

 يجري عمليات تحقّق ثابتة من صحة التحقّق في طلب التحليل المقدَّم.