หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
ประกอบด้วยวิธีการกรองและจัดลําดับรายการป้ายชื่อในบัญชี สําหรับข้อมูลเกี่ยวกับ ตัวเลือก ให้ดูตัวเลือก
วิธีการ
| ชื่อวิธี | ชนิดการส่งคืน | คำอธิบาย |
|---|---|---|
| รับ | LabelIterator | รับตัวทําซ้ําที่ใช้ในการคํานวณซ้ําผ่านรายการของป้ายชื่อ |
| orderBy(สตริง orderBy) | LabelSelector | นําลําดับที่ระบุไปใช้กับป้ายชื่อที่เลือก |
| withCondition(เงื่อนไขสตริง) | LabelSelector | ใช้เงื่อนไขการกรองกับป้ายชื่อ |
| withIds(string[], ids) | LabelSelector | รับป้ายผนึกที่มี ID ที่ระบุ |
| withLimit(int limit) | LabelSelector | รับป้ายชื่อ n อันดับแรก ที่ตรงกับเกณฑ์การเลือก |
รับ
รับตัว ทําซ้ํา ที่ใช้ในการคํานวณซ้ําผ่านรายการของป้ายชื่อ
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| LabelIterator | ตัวทําซ้ําที่ใช้เพื่อวนซ้ําผ่านป้ายชื่อที่เลือก |
orderBy(สตริง orderBy)
นําลําดับที่ระบุไปใช้กับป้ายชื่อที่เลือก
ระบุพารามิเตอร์ orderBy ในฟอร์ม "columnName orderDirection" โดยที่:
- columnName เป็นหนึ่งในคอลัมน์ที่ได้รับการสนับสนุน
- orderDirection คือลําดับในการเรียงลําดับผลลัพธ์ ตั้งค่าเป็น ASC เพื่อเรียงลําดับผลลัพธ์จากน้อยไปหามาก หรือ DESC เพื่อเรียงลําดับผลลัพธ์จากมากไปหาน้อย ค่าเริ่มต้นคือ ASC
ตัวอย่างเช่น การโทรต่อไปนี้จะส่งกลับผลลัพธ์จากน้อยไปหามากตามชื่อของป้ายชื่อ
selector = selector.orderBy("Name");
ถ้าคุณระบุคอลัมน์จํานวน เช่น KeywordCount ตัวเลือกจะเรียงลําดับตามจํานวน แล้วตามด้วยชื่อจากน้อยไปหามาก
ตัวเลือกสนับสนุนการจัดลําดับเอนทิตีตามหนึ่งเขตข้อมูลเท่านั้น คุณไม่สามารถจัดลําดับรายการของเอนทิตีตามเขตข้อมูล x และภายใน x ตามเขตข้อมูล y และอื่นๆ ถ้าคุณระบุการโทรมากกว่าหนึ่งครั้งorderBy()ในสายโซ่หรือในสายตัวเลือกที่แยกต่างหาก สคริปต์จะเรียงลําดับรายการของเอนทิตีโดยใช้เขตข้อมูลที่ระบุในการโทรล่าสุดorderBy()
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| orderBy | สตริง | ลําดับที่จะนําไปใช้ |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| LabelSelector | ตัวเลือกที่มีการเรียงลําดับ |
withCondition(String condition)
ใช้เงื่อนไขการกรองกับป้ายชื่อ
ระบุพารามิเตอร์ เงื่อนไข ในรูปแบบ "columnName operator value" โดยที่:
- columnName เป็นหนึ่งในคอลัมน์ที่ได้รับการสนับสนุน
- เป็นหนึ่งในตัวดําเนินการที่ได้รับการสนับสนุน
ตัวดําเนินการ
ตัวดําเนินการที่คุณใช้จะขึ้นอยู่กับชนิดของคอลัมน์ ตัวดําเนินการต้องตรงตามตัวพิมพ์ใหญ่-เล็ก ตัวอย่างเช่น ใช้ STARTS_WITH แทน starts_with
ตัวดําเนินการสําหรับคอลัมน์ที่มีจํานวนเต็มและค่าแบบยาว:
<
<=
>
>=
=
!=
ตัวดําเนินการสําหรับคอลัมน์ที่มีค่า double:
<
>
ตัวดําเนินการสําหรับคอลัมน์ที่มีค่าสตริง มีดังนี้
=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE
ตัวดําเนินการสําหรับคอลัมน์ที่ประกอบด้วยค่าการแจงนับ มีดังนี้
=
!=
IN []
NOT_IN []
ตัวดําเนินการสําหรับคอลัมน์ที่มีอาร์เรย์ของสตริง มีดังนี้
CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE
คอลัมน์ที่สนับสนุนสําหรับการกรองป้ายชื่อ ชื่อคอลัมน์เป็นแบบตรงตามตัวพิมพ์ใหญ่-เล็ก
| คอลัมน์ | พิมพ์ | ตัวอย่าง |
|---|---|---|
| ชื่อ | สตริง | ชื่อของป้ายชื่อwithCondition("Name = 'foo'") |
| KeywordCount | สตริง | จํานวนคําสําคัญที่เชื่อมโยงกับป้ายชื่อwithCondition("KeywordCount > 5") |
| AdCount | สตริง | จํานวนโฆษณาที่เชื่อมโยงกับป้ายกํากับwithCondition("AdCount > 5") |
| AdGroupCount | สตริง | จํานวนกลุ่มโฆษณาที่เกี่ยวข้องกับป้ายกํากับwithCondition("AdGroupCount > 5") |
| CampaignCount | สตริง | จํานวนแคมเปญที่เกี่ยวข้องกับป้ายกํากับwithCondition("CampaignCount > 5") |
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| เงื่อนไข | สตริง | เงื่อนไขที่จะเพิ่มลงในตัวเลือก |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| LabelSelector | ตัวเลือกที่มีเงื่อนไขที่ใช้ |
withIds(string[], ids)
รับป้ายผนึกที่มี ID ที่ระบุ
คุณสามารถใช้เงื่อนไขอย่างน้อยหนึ่งข้อกับตัวเลือกได้ ห่วงโซ่ของเงื่อนไขจะถือว่าเป็นการดําเนินการ AND ตัวอย่างเช่น เอนทิตีจะถูกเลือกก็ต่อเมื่อเงื่อนไข A เป็นจริง และเงื่อนไข B เป็นจริง ตัวอย่างเช่น การโทรต่อไปนี้เลือกเฉพาะป้ายชื่อ 33333 เท่านั้น
AdsApp.labels()
.withIds(['11111', '22222', '33333'])
.withIds(['33333', '44444', '55555']);
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| รหัส | สตริง[] | อาร์เรย์ของ ID ป้ายชื่อ สําหรับขีดจํากัด โปรดดูขีดจํากัดการดําเนินการสคริปต์ |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| LabelSelector | ตัวเลือกที่มี ID ที่นําไปใช้ |
withLimit(int limit)
รับป้ายชื่อ n อันดับแรก ที่ตรงกับเกณฑ์การเลือก
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| ขีดจํากัด | int | จํานวนป้ายชื่อที่จะส่งกลับ จํานวนจริงอาจน้อยกว่า |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| LabelSelector | ตัวเลือกที่มีการใช้ขีดจํากัด |