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

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

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

string

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

string

النتائج فقط. يسرد هذا الحقل أسماء جميع العناصر، سواء كانت قطعة أو موردًا آخر، والتي تقطع المقاييس عند تضمينها في طلبات البحث وعند استخدام العنصر الموصوف في عبارة FROM. ويتم تعيينه فقط للعناصر التي تكون فئتها هي "Resource" (الموارد).
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

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