API ขั้นสูง

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

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

Google Analytics 4
คุณใช้ Google Analytics 4 เพื่อติดตามการเข้าชมเว็บไซต์และ ปรับราคาเสนอแคมเปญตามนั้นได้ หากลิงก์พร็อพเพอร์ตี้ Google Analytics 4 กับบัญชี Google Ads คุณจะวิเคราะห์กิจกรรมของลูกค้าใน เว็บไซต์ได้ด้วย ข้อมูลนี้แสดงให้เห็นถึงจำนวนการเข้าชมเว็บไซต์หรือยอดขายที่มาจาก Google Ads และช่วยปรับปรุงโฆษณาและเว็บไซต์ คุณดูข้อมูลเพิ่มเติมเกี่ยวกับการลิงก์บัญชี Analytics กับ Google Ads ได้ผ่าน Google Analytics 4
Google BigQuery
คุณโหลดข้อมูลจำนวนมากไปยัง Google Cloud Storage แล้ว ค้นหาข้อมูลนั้นโดยใช้ Google BigQuery ได้ เช่น คุณสามารถโหลดข้อมูลสภาพอากาศสาธารณะ ในช่วง 10 ปีที่ผ่านมา แล้วค้นหาอุณหภูมิเฉลี่ยของภูมิภาคใน สคริปต์ที่ใช้ข้อมูลดังกล่าวในการปรับราคาเสนอ อีกกรณีหนึ่งคือการ ประมวลผลข้อมูลประสิทธิภาพของบัญชีในช่วงหลายปี
YouTube และข้อมูลวิเคราะห์ YouTube
คุณสามารถดึงและอัปเดตวิดีโอ เพลย์ลิสต์ ฯลฯ รวมถึงข้อมูลประสิทธิภาพของวิดีโอเพื่อใช้ในการตัดสินใจเกี่ยวกับการเสนอราคา
Google ปฏิทิน
สคริปต์สามารถสร้างกิจกรรมสำหรับงานในอนาคต (เช่น เรียกใช้รายงานประสิทธิภาพของแคมเปญในอีก 2 สัปดาห์นับจากวันนี้) หรือดำเนินการตามรายการที่คุณสร้างในปฏิทิน (เช่น เปิดใช้แคมเปญในวันที่ที่เฉพาะเจาะจง)
เนื้อหา Shopping
สคริปต์ของคุณใช้ Google Content API for Shopping ใน Apps Script ได้ API นี้ช่วยให้ผู้ใช้ Google Merchant Center สามารถอัปโหลดและจัดการข้อมูลผลิตภัณฑ์ที่แสดง รวมถึงจัดการบัญชี Merchant Center ได้ ในสคริปต์ การดำเนินการนี้ มีประโยชน์ในการตรวจสอบข้อมูลผลิตภัณฑ์และลิงก์ผลิตภัณฑ์ที่เฉพาะเจาะจงกับโฆษณาที่เฉพาะเจาะจง
Google Tasks
สคริปต์สามารถสร้างรายการการช่วยเตือนสำหรับงานในอนาคต (เช่น เรียกใช้รายงานประสิทธิภาพสำหรับแคมเปญในอีก 2 สัปดาห์นับจากวันนี้) หรือดำเนินการตามรายการที่คุณสร้างไว้ในรายการการช่วยเตือน (เช่น เปิดใช้แคมเปญในวันที่ที่เฉพาะเจาะจง)
Google สไลด์
สคริปต์สามารถส่งออกรายละเอียดหรือสถิติแคมเปญไปยัง Google สไลด์เพื่อ เผยแพร่ข้อมูลดังกล่าวในรูปแบบที่นำเสนอได้

เปิดใช้ Advanced API

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

ซึ่งจะแสดงกล่องโต้ตอบ API ขั้นสูง เลือก API ที่ต้องการเปิดใช้

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

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

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

ตอนนี้ให้ปิดกล่องโต้ตอบ Advanced APIs เพื่อกลับไปที่โปรแกรมแก้ไข ระบบจะเปิดใช้ 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 เชื่อมโยงอยู่ คุณดูหมายเลขโปรเจ็กต์ของสคริปต์ได้โดยเปิดหน้าคอนโซล Google API จากกล่องโต้ตอบ API ขั้นสูง ระบบจะสร้างรหัสโปรเจ็กต์นี้เมื่อคุณสร้างสคริปต์ และจะเชื่อมโยงกับ ผู้ใช้ที่สร้างสคริปต์ Google Ads หากต่อมามีการนำผู้ใช้ที่สร้างสคริปต์ ออกจากบัญชี ผู้ใช้ที่พยายามเข้าถึงสคริปต์จะ ได้รับแจ้งให้ให้สิทธิ์สคริปต์อีกครั้งและตั้งค่าการอ้างอิง API ขั้นสูงอีกครั้ง ระบบจะสร้างรหัสโปรเจ็กต์ Google Developer ใหม่ด้วย และคุณจะต้อง ตั้งค่า Advanced API อีกครั้งตามที่อธิบายไว้ก่อนหน้านี้ในเอกสารนี้

แท็กเริ่มการทำงาน

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

สิทธิ์

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

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

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

โควต้า

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

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

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