REST Resource: curators.dataSegments

ทรัพยากร: DataSegment

กำหนดตัวระบุสำหรับกลุ่มพื้นที่โฆษณาที่ผู้ดูแลจัดการหรือเจ้าหน้าที่วางแผนโฆษณาสามารถกำหนดเป้าหมายได้ใน UI ของดีลหรือแพ็กเกจการประมูล การดูแลจัดการพื้นที่โฆษณาดำเนินการโดยผู้ดูแลจัดการในแพลตฟอร์มภายนอก -- Next ID: 9 --

การแสดง JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "cpmFee": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
  "userListId": string
}
ช่อง
name

string

เปลี่ยนแปลงไม่ได้ ตัวระบุ ตัวระบุที่ไม่ซ้ำกันสำหรับกลุ่มเป้าหมายตามข้อมูล รหัสบัญชีสอดคล้องกับรหัสบัญชีที่สร้างกลุ่ม รูปแบบ: curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}

createTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่สร้างกลุ่มข้อมูล

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่อัปเดตกลุ่มเป้าหมายตามข้อมูลครั้งล่าสุด

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

state

enum (State)

เอาต์พุตเท่านั้น สถานะของกลุ่มข้อมูล

ระบบจะเรียกเก็บค่าธรรมเนียมเมื่อบัญชีอื่นๆ ใช้กลุ่มเป้าหมายตามข้อมูลนี้ เช่น เมื่อบัญชีอื่นๆ เพิ่มกลุ่มเป้าหมายตามข้อมูลนี้ลงในดีลหรือแพ็กเกจการประมูล ประเภทค่าธรรมเนียมของกลุ่มข้อมูลจะเปลี่ยนแปลงไม่ได้เมื่อตั้งค่าแล้ว ต่อไปนี้คือรายการช่องที่แยกกันโดยสิ้นเชิง ระบบจะตั้งค่าช่องอย่างน้อย 1 ช่องในการตอบกลับ ดังนี้
cpmFee

object (Money)

ไม่บังคับ ค่าธรรมเนียมคงที่ที่เรียกเก็บต่อการแสดงผลพันครั้ง เมื่อตั้งค่าแล้ว คุณจะเปลี่ยนรหัสสกุลเงินไม่ได้

millipercentOfMediaFee

string (int64 format)

ไม่บังคับ ระบบจะเรียกเก็บค่าธรรมเนียมเป็นเปอร์เซ็นต์ของต้นทุนการแสดงผล ซึ่งแสดงเป็นหน่วยมิลลิเปอร์เซ็นต์ เช่น 1% จะแสดงเป็น 1000

สิ้นสุดฟิลด์ที่แยกกัน
userListId

string

ไม่บังคับ เปลี่ยนแปลงไม่ได้ รหัสของรายชื่อผู้ใช้ที่รวมอยู่ในกลุ่มเป้าหมายตามข้อมูลนี้

ผู้ดูแลจัดการที่มีบัญชีพาร์ทเนอร์ด้านข้อมูลที่ลิงก์ไว้สามารถสร้างกลุ่มเป้าหมายตามข้อมูลที่รวมรายชื่อผู้ใช้ซึ่งเป็นของบัญชีพาร์ทเนอร์ด้านข้อมูลที่ลิงก์ไว้ได้ คุณอัปโหลดและจัดการรายชื่อผู้ใช้ได้โดยใช้ Data Manager API การลิงก์รายชื่อผู้ใช้กับกลุ่มเป้าหมายตามข้อมูลช่วยให้คุณกำหนดกลุ่มพื้นที่โฆษณาที่อิงตามกลุ่มเป้าหมายที่สร้างขึ้นได้

รัฐ

เอาต์พุตเท่านั้น ใช้วิธีเปิดใช้งานและปิดใช้งานเพื่อเปลี่ยนสถานะ

Enum
STATE_UNSPECIFIED ค่าเริ่มต้น
ACTIVE กลุ่มข้อมูลทำงานอยู่
INACTIVE กลุ่มข้อมูลไม่มีการใช้งาน
SUSPENDED กลุ่มข้อมูลถูกระงับและเปิดใช้งานไม่ได้

เมธอด

activate

เปิดใช้งานกลุ่มข้อมูล

create

สร้างกลุ่มข้อมูลที่ผู้ดูแลที่ระบุเป็นเจ้าของ

deactivate

ปิดใช้งานกลุ่มข้อมูล

get

รับกลุ่มเป้าหมายตามข้อมูลของคุณตามชื่อที่ระบุ

list

แสดงรายการกลุ่มเป้าหมายตามข้อมูลที่ผู้ดูแลจัดการเป็นเจ้าของ

patch

อัปเดตกลุ่มข้อมูล