โครงสร้างพื้นฐานสคริปต์ Google Ads ใหม่อิงตาม Google Ads API คุณอาจต้องอัปเดตสคริปต์ที่มีอยู่เนื่องจากสถาปัตยกรรมของ API นั้นแตกต่างกัน เราพยายามอย่างเต็มที่เพื่อให้เกิดความเข้ากันได้แบบย้อนหลังมากที่สุด ดังนั้นการเปลี่ยนแปลงเหล่านี้จึงควรมีเพียงเล็กน้อย
รายงาน
รายงาน AWQL หลายรายการจะยังคงทํางานต่อไป ในการทำงานเบื้องหลัง เมื่อใช้โครงสร้างพื้นฐานใหม่ สคริปต์จะแปลงการค้นหา AWQL เป็น GAQL (ภาษาการค้นหาใหม่สำหรับ Google Ads API) ให้เรียกใช้กับแบ็กเอนด์ใหม่ แล้วแปลงผลลัพธ์กลับไปเป็นรูปแบบที่รายงาน AWQL ใช้ในตอนแรก การค้นหาที่มี GAQL จะส่งผ่านตามที่เป็นอยู่
ด้วยเหตุนี้ เราจึงขอแนะนําให้คุณตรวจสอบสคริปต์และอัปเดตการค้นหา AWQL เป็น GAQL เมื่อเป็นไปได้ คุณสามารถใช้เครื่องมือย้ายข้อมูลคําค้นหาซึ่งใช้ตรรกะเดียวกับสคริปต์เพื่อกําหนดคําค้นหา GAQL สําหรับคําค้นหา AWQL หนึ่งๆ หรือจะใช้เครื่องมือสร้างคําค้นหาแบบอินเทอร์แอกทีฟเพื่อช่วยสร้างคําค้นหาก็ได้
ต่อไปนี้เป็นข้อจำกัดบางประการสำหรับการแปล AWQL เป็น GAQL อัตโนมัติ:
- การค้นหา AWQL บางรายการอาจแปลเป็นข้อความค้นหา GAQL ได้ไม่สอดคล้องกัน ในกรณีเหล่านี้ ระบบจะบันทึกข้อความแสดงข้อผิดพลาดพร้อมรายละเอียดบางอย่างเกี่ยวกับสิ่งที่ผิดพลาดไว้เพื่อช่วยให้คุณแก้ไขด้วยตนเองได้
- GAQL ไม่รองรับรายงานบางประเภทจาก AWQL
- GAQL ไม่รองรับ "แถวการแสดงผลเป็น 0" การระบุว่ารายงานควรมีการแสดงผลเป็น 0 จะทำให้เกิดข้อผิดพลาด
- ช่องที่คลุมเครือบางช่องใช้ในตัวกรองไม่ได้ เช่น "บรรทัดแรก" อาจอ้างอิงช่องโฆษณาต่างๆ กี่ช่องก็ได้
- ฟิลด์บางฟิลด์อาจแสดงผลลัพธ์ในรูปแบบอื่น เช่น การแบ่งผลการค้นหารายการเดียวออกเป็นหลายคอลัมน์
การจัดระเบียบตัวเลือก
เมื่อดึงข้อมูลโดยใช้สคริปต์ การใช้การเรียก withCondition
และ orderBy
เพื่อจํากัดหรือจัดลําดับผลลัพธ์ใน Iterator นั้นเป็นเรื่องปกติ ตอนนี้ช่องในการเรียกใช้เหล่านี้ใช้ชื่อ Google Ads API ใหม่ ตัวอย่างเช่น หากต้องการกรองตามชื่อแคมเปญ ก่อนหน้านี้คุณอาจใช้
.withCondition('CampaignName = "SOME_CAMPAIGN_NAME"')
แต่ในตอนนี้ คุณควรใช้ชื่อฟิลด์ใหม่สำหรับเงื่อนไขเหล่านี้เมื่อเป็นไปได้
.withCondition('campaign.name = "SOME_CAMPAIGN_NAME"')
อย่างไรก็ตาม เราได้พยายามจับคู่ชื่อเดิมกับชื่อใหม่แล้ว ดังนั้นหากสคริปต์ของคุณยังคงใช้ CampaignName
ระบบจะแทนที่ด้วย campaign.name
โดยอัตโนมัติเมื่อรันไทม์เพื่อให้สคริปต์ยังคงทํางานได้ หากพบปัญหาเกี่ยวกับชื่อรูปแบบเก่า ให้อัปเดตสคริปต์เพื่อใช้ชื่อรูปแบบใหม่เป็นขั้นตอนแก้ปัญหาแรก
จำกัดสูงสุด
ขีดจำกัดจำนวนมากเหมือนกันกับในโครงสร้างพื้นฐานเดิม และการเปลี่ยนแปลงที่เกิดขึ้นที่นี่มักจะช่วยเพิ่มประสิทธิภาพได้
- ขีดจำกัดเวลาจะเหมือนกัน สคริปต์อาจทํางานเป็นเวลา 30 นาที
- ตัวดำเนินการวนซ้ำรายการเดียวจะแสดงผลเอนทิตี 50,000 รายการโดยค่าเริ่มต้น แต่สามารถลบล้างได้ ก่อนหน้านี้ขีดจำกัด 50,000 รายการนี้ปรับแต่งไม่ได้
- ตัวเลือกรายการเดียวจะจัดการรหัสได้สูงสุด 10,000 รายการ (ไม่มีการเปลี่ยนแปลง)
- โครงสร้างพื้นฐานใหม่นี้ไม่มีการจํากัดจํานวนเอนทิตีที่ประมวลผลได้ในสคริปต์เดียว ก่อนหน้านี้ขีดจํากัดคือ 250,000 รายการ
- โครงสร้างพื้นฐานใหม่ไม่จำกัดจำนวนคีย์เวิร์ดหรือโฆษณาที่สร้างได้ต่อการดำเนินการ ก่อนหน้านี้ขีดจํากัดคือ 250,000 รายการ
- เอาต์พุตการบันทึกจะถูกตัดที่ 100 KB (ไม่มีการเปลี่ยนแปลง)
- โควต้าสำหรับบริการ Apps Script (SpreadsheetApp, MailApp ฯลฯ) จะไม่มีการเปลี่ยนแปลง
- ระบบจะบังคับใช้โควต้าสําหรับ Google Ads เหมือนกับว่าคุณใช้ API กล่าวคือ สคริปต์จะขึ้นอยู่กับขีดจํากัดอัตรา API แต่วิธีนี้ช่วยให้เข้าถึงรายงานได้มากขึ้นหรือทําการเปลี่ยนแปลงได้มากขึ้นต่อการเรียกใช้
การเปลี่ยนแปลงอื่นๆ
ExecutionInfo
จะไม่แสดง getRemainingCreateQuota()
หรือ getRemainingGetQuota()
อีกต่อไปเนื่องจากโควต้าเหล่านั้นไม่มีผลในประสบการณ์การใช้งานแบบใหม่