API ขั้นสูง

API ขั้นสูงในสคริปต์ Google Ads ช่วยให้นักพัฒนาซอฟต์แวร์ที่มีประสบการณ์เชื่อมต่อกับ Google API สาธารณะบางรายการได้โดยใช้การตั้งค่าน้อยกว่าการใช้อินเทอร์เฟซ HTTP คุณใช้ API เหล่านี้ได้เหมือนกับบริการในตัวของสคริปต์ และ API เหล่านี้จะมอบความสะดวกสบายแบบเดียวกัน เช่น การเติมข้อความอัตโนมัติและการให้สิทธิ์อัตโนมัติ

การใช้งานที่เป็นไปได้สําหรับ Advanced API

Google Analytics

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

Google BigQuery

คุณสามารถโหลดข้อมูลจํานวนมากลงใน Google Cloud Storage แล้วค้นหาข้อมูลดังกล่าวโดยใช้ Google BigQuery เช่น คุณสามารถโหลดข้อมูลสภาพอากาศสาธารณะในช่วง 10 ปีที่ผ่านมา แล้วค้นหาอุณหภูมิเฉลี่ยของภูมิภาคในสคริปต์ที่ใช้ข้อมูลดังกล่าวในการปรับราคาเสนอ อีกวิธีหนึ่งคือใช้เพื่อประมวลผลข้อมูลประสิทธิภาพของบัญชีในช่วงหลายปี

YouTube และ YouTube Analytics

คุณสามารถเรียกดูและอัปเดตวิดีโอ เพลย์ลิสต์ และอื่นๆ รวมถึงข้อมูลประสิทธิภาพของวิดีโอเพื่อใช้ในการตัดสินใจเสนอราคา

Google ปฏิทิน

สคริปต์สามารถสร้างเหตุการณ์สําหรับงานในอนาคต (เช่น เรียกใช้รายงานประสิทธิภาพสําหรับแคมเปญในอีก 2 สัปดาห์นับจากวันนี้) หรือดําเนินการตามรายการที่คุณสร้างในปฏิทิน (เช่น เปิดใช้แคมเปญในวันที่ที่เจาะจง)

เนื้อหา Shopping

สคริปต์ของคุณสามารถใช้ Google Content API for Shopping ใน Apps Script API นี้ช่วยให้ผู้ใช้ Google Merchant Center สามารถอัปโหลดและจัดการข้อมูลผลิตภัณฑ์ที่แสดง รวมถึงจัดการบัญชี Merchant Center ได้ ในสคริปต์ ข้อมูลนี้อาจมีประโยชน์ในการตรวจสอบข้อมูลผลิตภัณฑ์และลิงก์ผลิตภัณฑ์ที่เฉพาะเจาะจงกับโฆษณาที่เฉพาะเจาะจง

Google Tasks

สคริปต์สามารถสร้างรายการช่วยเตือนสำหรับงานในอนาคต (เช่น เรียกใช้รายงานประสิทธิภาพของแคมเปญในอีก 2 สัปดาห์นับจากวันนี้) หรือดำเนินการตามรายการที่คุณสร้างขึ้นในรายการช่วยเตือน (เช่น เปิดใช้แคมเปญในวันที่ที่เจาะจง)

Google สไลด์

สคริปต์สามารถส่งออกรายละเอียดหรือสถิติของแคมเปญไปยัง Google สไลด์เพื่อเผยแพร่ข้อมูลดังกล่าวในรูปแบบที่นำเสนอได้

เปิดใช้ API ขั้นสูง

หากต้องการดูว่า Google API ใดบ้างที่ใช้เป็น API ขั้นสูงได้ ให้คลิกปุ่ม Advanced APIs ในแถบเครื่องมือแก้ไขด้านบน

ซึ่งจะเปิดกล่องโต้ตอบ Advanced APIs เลือก API ที่ต้องการเปิดใช้

จากนั้นคลิกลิงก์คอนโซล Google API เพื่อเปิดหน้าคอนโซล API ในคอนโซลที่มีโปรเจ็กต์ที่เชื่อมโยงกับสคริปต์ หรือหากยังไม่ได้เลือกโปรเจ็กต์ ให้เลือกโปรเจ็กต์จากรายการแบบเลื่อนลงของโปรเจ็กต์ ค้นหา API ที่ต้องการใช้ในสคริปต์โดยป้อนชื่อ API ในแถบค้นหา

ในผลการค้นหา ให้เลือก API แล้วเลือกเปิดใช้ในหน้าถัดไป หากเห็นปุ่มปิดใช้ แสดงว่า API นี้เปิดใช้อยู่แล้ว ทําซ้ำการดําเนินการนี้สําหรับ API แต่ละรายการที่ต้องการเปิดใช้

หากต้องการดูรายการ API ที่เปิดใช้สําหรับโปรเจ็กต์ ให้เลือกหน้าแดชบอร์ด ตรวจสอบว่ามี API ขั้นสูงทั้งหมดที่ต้องการใช้สคริปต์แสดงอยู่

จากนั้นปิดกล่องโต้ตอบ Advanced API เพื่อกลับไปที่เครื่องมือแก้ไข ระบบจะเปิดใช้ API ใหม่สําหรับสคริปต์และแสดงในรายการเติมข้อความอัตโนมัติ

API ที่พร้อมใช้งาน

API ต่อไปนี้พร้อมให้ใช้งาน

ชื่อ API	เอกสารประกอบ
Google Analytics	https://developers.google.com/apps-script/advanced/analytics
Google BigQuery	https://developers.google.com/apps-script/advanced/bigquery
Google ปฏิทิน	https://developers.google.com/apps-script/advanced/calendar
Google สไลด์	https://developers.google.com/apps-script/advanced/slides
Google Tasks	https://developers.google.com/apps-script/advanced/tasks
เนื้อหา Shopping	https://developers.google.com/apps-script/advanced/shopping-content
YouTube	https://developers.google.com/apps-script/advanced/youtube
YouTube Analytics	https://developers.google.com/apps-script/advanced/youtube-analytics

นอกจากนี้ คุณยังดูตัวอย่างวิธีใช้ API เหล่านี้ได้ในหน้าข้อมูลโค้ด

ข้อควรพิจารณาขั้นสุดท้าย

สิ่งที่ควรคำนึงถึงเมื่อใช้ Advanced API มีดังนี้

รหัสโปรเจ็กต์

สคริปต์ Google Ads แต่ละรายการมีรหัสโปรเจ็กต์ (หรือที่เรียกว่าหมายเลขโปรเจ็กต์) ของ Google Cloud Platform ที่เชื่อมโยงอยู่ คุณดูหมายเลขโปรเจ็กต์ของสคริปต์ได้โดยเปิดหน้าคอนโซล Google API จากกล่องโต้ตอบ Advanced APIs ระบบจะสร้างรหัสโปรเจ็กต์นี้เมื่อคุณสร้างสคริปต์ และผูกไว้กับผู้ใช้ที่สร้างสคริปต์ Google Ads หากนำผู้ใช้ที่สร้างสคริปต์ออกจากบัญชีในภายหลัง ผู้ใช้ที่พยายามเข้าถึงสคริปต์จะได้รับแจ้งให้ให้สิทธิ์สคริปต์อีกครั้งและตั้งค่าการพึ่งพา Advanced API อีกครั้ง ระบบจะสร้างรหัสโปรเจ็กต์นักพัฒนาแอป Google ใหม่ด้วย และคุณจะต้องตั้งค่า API ขั้นสูงอีกครั้งตามที่อธิบายไว้ก่อนหน้านี้ในเอกสารนี้

การอ้างอิง

เฉพาะผู้ใช้ที่สร้างสคริปต์ในบัญชีเท่านั้นที่จะเปลี่ยนการพึ่งพา API ขั้นสูงสำหรับสคริปต์นั้นได้

สิทธิ์

เมื่อเข้าถึง API สคริปต์จะใช้สิทธิ์ของผู้ใช้ที่อนุญาตให้สคริปต์ทำงาน ตรวจสอบว่าผู้ใช้ที่อนุญาตให้ใช้สคริปต์มีสิทธิ์เข้าถึง Advanced API ทั้งหมดที่ใช้อยู่ รวมถึงข้อมูลที่สคริปต์ต้องการ หากคุณใช้ Google Analytics API โปรดตรวจสอบว่าผู้ใช้ที่อนุญาตให้ใช้สคริปต์มีสิทธิ์ที่จําเป็นสําหรับบัญชี Analytics ที่จะเข้าถึง

ข้อกำหนดและเงื่อนไข

API ขั้นสูงแต่ละรายการอาจมีข้อกําหนดและเงื่อนไขเป็นของตนเอง ซึ่งคุณควรยอมรับเมื่อเปิดใช้ API ในคอนโซล Google API

โควต้า

API ขั้นสูงส่วนใหญ่จะมีโควต้ารายวันแบบไม่มีค่าใช้จ่ายที่เชื่อมโยงอยู่ เมื่อสคริปต์ใช้โควต้าเกินแล้ว API จะหยุดทํางานจนกว่าคุณจะขอข้อมูลเพิ่มเติมหรือโควต้าฟรีจะเพิ่มเข้ามา คุณสามารถตรวจสอบโควต้าที่ใช้โดยสคริปต์ได้โดยเปิดคอนโซล Google API สําหรับสคริปต์จากกล่องโต้ตอบ Advanced API คอนโซล Google API ยังมีวิธีขอโควต้าเพิ่มเติมสําหรับ API ด้วย

การเรียกเก็บเงิน

API ขั้นสูงบางรายการกำหนดให้คุณต้องชำระเงินเพื่อใช้งาน การชําระเงินเหล่านี้จะจัดการผ่านโปรเจ็กต์ Google Cloud Platform ที่เชื่อมโยงกับสคริปต์ของคุณ ไม่ใช่ผ่าน Google Ads ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีเปิดใช้การเรียกเก็บเงินสำหรับโปรเจ็กต์ Google Cloud Platform ของสคริปต์ได้ในเอกสารประกอบ