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