REST Resource: googleAdsFields

المورد: GoogleAdsField

حقل أو مورد (أداة) تستخدمه GoogleAdsService.

تمثيل JSON 
{
  "resourceName": string,
  "category": enum (GoogleAdsFieldCategory),
  "selectableWith": [
    string
  ],
  "attributeResources": [
    string
  ],
  "metrics": [
    string
  ],
  "segments": [
    string
  ],
  "enumValues": [
    string
  ],
  "dataType": enum (GoogleAdsFieldDataType),
  "name": string,
  "selectable": boolean,
  "filterable": boolean,
  "sortable": boolean,
  "typeUrl": string,
  "isRepeated": boolean
}
الحقول
resourceName

string

النتائج فقط. اسم المورد للعنصر تكون أسماء موارد العناصر على النحو التالي:

googleAdsFields/{name}
category

enum (GoogleAdsFieldCategory)

النتائج فقط. فئة العنصر.
selectableWith[]

string

النتائج فقط. أسماء جميع الموارد والأقسام والمقاييس التي يمكن اختيارها مع العنصر الموصوف.
attributeResources[]

string

النتائج فقط. تمثّل هذه السمة أسماء جميع الموارد التي يمكن اختيارها مع العنصر الموضّح. ولا تقسّم الحقول من هذه الموارد المقاييس عند تضمينها في طلبات البحث.

يتم تعيين هذا الحقل فقط للعناصر التي تكون فئتها هي "الموارد".
metrics[]

string

النتائج فقط. يسرد هذا الحقل أسماء جميع المقاييس التي يمكن اختيارها مع العنصر الموصوف عند استخدامها في عبارة FROM. يتم تعيينه فقط للعناصر التي تكون فئتها هي AR.
segments[]

string

النتائج فقط. يسرد هذا الحقل أسماء جميع العناصر، سواء كانت مقطعًا أو موردًا آخر، والتي تعمل على تقسيم المقاييس عند تضمينها في طلبات البحث وعند استخدام الأداة الموصوفة في عبارة FROM. يتم تعيينه فقط للعناصر التي تكون فئتها هي AR.
enumValues[]

string

النتائج فقط. يمكن أن تفترض قيم العنصر ما إذا كان حقلاً من النوع ENUM.

يتم تعيين هذا الحقل فقط للعناصر من الفئة SEGMENT أو ATTRIBUTE.
dataType

enum (GoogleAdsFieldDataType)

النتائج فقط. يحدد هذا الحقل العوامل التي يمكن استخدامها مع الأداة في عبارات WHERE.
name

string

النتائج فقط. اسم العنصر.
selectable

boolean

النتائج فقط. ما إذا كان يمكن استخدام الأداة في عبارة SELECT في استعلامات البحث.
filterable

boolean

النتائج فقط. ما إذا كان يمكن استخدام الأدوات في عبارة WHERE في طلبات البحث.
sortable

boolean

النتائج فقط. ما إذا كان يمكن استخدام الأدوات في عبارة ORDER BY في استعلامات البحث.
typeUrl

string

النتائج فقط. تمثّل هذه السمة عنوان URL للنموذج الأوّلي الذي يصف نوع بيانات العنصر.
isRepeated

boolean

النتائج فقط. ما إذا كان العنصر يتم تكراره أم لا.

GoogleAdsFieldCategory

فئة العنصر.

عمليات التعداد
UNSPECIFIED غير محدّدة
UNKNOWN غير معروف
RESOURCE العنصر الموصوف هو مورد.
ATTRIBUTE العنصر الموصوف هو حقل وهو سمة لمورد. قد يؤدي تضمين حقل سمة موارد في استعلام إلى تقسيم الاستعلام إذا كان المورد الذي يُنسب إليه يُقسم المورد الموجود في عبارة FROM.
SEGMENT العنصر الموصوف هو حقل ويقسّم دائمًا طلبات البحث.
METRIC العنصر الموصوف هو حقل ومقياس. ولا يتم تقسيم طلبات البحث إلى شرائح.

GoogleAdsFieldDataType

في ما يلي الأنواع المختلفة التي قد تتخذها أداة GoogleAdsService.

عمليات التعداد
UNSPECIFIED غير محدّدة
UNKNOWN غير معروف
BOOLEAN

الخرائط إلى google.protobuf.BoolValue

عوامل التشغيل المطبقة: =, !=
DATE

خرائط إلى google.protobuf.StringValue. ومع ذلك، يمكن مقارنتها باستخدام مجموعة من عوامل التشغيل الخاصة بالتواريخ.

العوامل القابلة للتطبيق: = و< و> و<= و>= وBETWEEN وDURING وIN
DOUBLE

الخرائط إلى google.protobuf.DoubleValue

العوامل القابلة للتطبيق: =, !=, <, >, IN, NOT IN
ENUM

خرائط إلى تعداد. ويمكن العثور على تعريفه المحدد على typeUrl.

عوامل التشغيل المطبقة: =, !=, IN, NOT IN
FLOAT

الخرائط إلى google.protobuf.FloatValue

العوامل القابلة للتطبيق: =, !=, <, >, IN, NOT IN
INT32

الخرائط إلى google.protobuf.Int32Value

عوامل التشغيل المطبقة: =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN
INT64

الخرائط إلى google.protobuf.Int64Value

عوامل التشغيل المطبقة: =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN
MESSAGE

يتم الربط مع نوع رسالة مخزن البروتوكول المؤقت. ويمكن العثور على تفاصيل نوع البيانات في typeUrl.

ليس هناك عوامل تشغيل تعمل مع حقول MESSAGE.
RESOURCE_NAME

خرائط إلى google.protobuf.StringValue. يمثل اسم المورد (المعرّف الفريد) لمورد أو أحد مفاتيحه الخارجية.

ليس هناك عوامل تشغيل تعمل مع حقول Resource_NAME.
STRING

خرائط إلى google.protobuf.StringValue.

عوامل التشغيل القابلة للتطبيق: =, !=, LIKE, NOT LIKE, IN, NOT IN
UINT64

الخرائط إلى google.protobuf.UInt64Value

عوامل التشغيل المطبقة: =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN

الطُرق

get

 لعرض الحقل المطلوب فقط.
عرض جميع الحقول التي تطابق طلب البحث.