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 ของ Pro ที่อธิบายประเภทข้อมูลของอาร์ติแฟกต์

isRepeated

boolean

เอาต์พุตเท่านั้น ระบุว่ามีอาร์ติแฟกต์ฟิลด์ซ้ำหรือไม่

GoogleAdsFieldCategory

หมวดหมู่ของอาร์ติแฟกต์

Enum
UNSPECIFIED ไม่ระบุ
UNKNOWN ไม่ทราบ
RESOURCE อาร์ติแฟกต์ที่อธิบายไว้คือทรัพยากร
ATTRIBUTE อาร์ติแฟกต์ที่อธิบายไว้คือช่องและเป็นแอตทริบิวต์ของทรัพยากร การรวมช่องแอตทริบิวต์ทรัพยากรไว้ในการค้นหาอาจจัดกลุ่มการค้นหา หากทรัพยากรที่ระบุแหล่งที่มานั้นเป็นกลุ่มทรัพยากรที่พบในคำสั่ง FROM
SEGMENT อาร์ติแฟกต์ที่อธิบายไว้คือช่องและแบ่งกลุ่มคำค้นหาเสมอ
METRIC อาร์ติแฟกต์ที่อธิบายไว้คือฟิลด์และเป็นเมตริก แต่จะไม่แบ่งกลุ่มคําค้นหา

GoogleAdsFieldDataType

ต่อไปนี้คือประเภทต่างๆ ที่อาร์ติแฟกต์ GoogleAdsService อาจรองรับ

Enum
UNSPECIFIED ไม่ระบุ
UNKNOWN ไม่ทราบ
BOOLEAN

แผนที่ไปยัง google.protobuf.BoolValue

โอเปอเรเตอร์ที่เกี่ยวข้อง: =, !=

DATE

แมปไปยัง google.protobuf.StringValue แต่สามารถเปรียบเทียบได้โดยใช้ชุดโอเปอเรเตอร์ที่เจาะจงสำหรับวันที่

โอเปอเรเตอร์ที่เกี่ยวข้อง ได้แก่ =, <, >, <=, >=, BETWEEN, DURING และ IN

DOUBLE

แมปไปยัง google.protocolbuf.DoubleValue

โอเปอเรเตอร์ที่เกี่ยวข้อง: =, !=, <, >, IN, NOT IN

ENUM

Maps ไปยัง enum ดูคำจำกัดความที่เฉพาะเจาะจงได้ที่ typeUrl

โอเปอเรเตอร์ที่เกี่ยวข้อง: =, !=, IN, NOT IN

FLOAT

แผนที่ไปยัง google.protocolbuf.FloatValue

โอเปอเรเตอร์ที่เกี่ยวข้อง: =, !=, <, >, IN, NOT IN

INT32

แผนที่ไปยัง google.protobuf.Int32Value

โอเปอเรเตอร์ที่เกี่ยวข้อง ได้แก่ =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN

INT64

แผนที่ไปยัง google.protocolbuf.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.protocolbuf.UInt64Value

โอเปอเรเตอร์ที่เกี่ยวข้อง ได้แก่ =, !=, <, >, <=, >=, BETWEEN, IN, NOT IN

เมธอด

get

แสดงผลเฉพาะฟิลด์ที่ขอ
แสดงช่องทั้งหมดที่ตรงกับคำค้นหา