Các API nâng cao trong tập lệnh Google Ads cho phép nhà phát triển kết nối với một số API công khai của Google mà không cần thiết lập nhiều như khi sử dụng giao diện HTTP. Bạn có thể sử dụng các API này giống như các dịch vụ tích hợp sẵn của tập lệnh và chúng mang lại những tiện ích tương tự như tự động hoàn thành và tự động uỷ quyền.
Hãy tham khảo trang đoạn mã của chúng tôi để xem một số ví dụ minh hoạ cách sử dụng các API này.
Các API nâng cao hiện có
- Google Analytics
- Lưu ý: API nâng cao
Analyticstrong hộp thoại API nâng cao nhắm đến API Universal Analytics phiên bản 3 đã ngừng hoạt động và các yêu cầu gửi đến API này sẽ không thành công. Tập lệnh Google Ads không hỗ trợ các dịch vụ nâng caoAnalyticsDatahoặcAnalyticsAdmincủa Google Analytics 4. Để truy vấn dữ liệu Google Analytics 4 từ một tập lệnh, hãy gửi yêu cầu HTTPS đến Google Analytics Data API bằng cách sử dụng dịch vụUrlFetchAppvà OAuth 2.0. Bạn cũng có thể liên kết tài sản Google Analytics 4 với tài khoản Google Ads để chia sẻ trực tiếp dữ liệu lượt chuyển đổi trên trang web và ứng dụng. Để biết hướng dẫn thiết lập, hãy xem Hướng dẫn thiết lập Analytics. - Google BigQuery
- Bạn có thể tải một lượng lớn dữ liệu vào Google Cloud Storage, sau đó truy vấn dữ liệu đó bằng Google BigQuery. Ví dụ: bạn có thể tải dữ liệu thời tiết công khai trong 10 năm qua, sau đó truy vấn nhiệt độ trung bình của một khu vực trong một tập lệnh sử dụng thông tin đó để điều chỉnh giá thầu. Một cách sử dụng khác là xử lý dữ liệu hiệu suất của tài khoản trong nhiều năm.
- Lịch Google
- Tập lệnh của bạn có thể tạo sự kiện cho các nhiệm vụ trong tương lai (ví dụ: chạy báo cáo hiệu suất cho chiến dịch của bạn sau 2 tuần kể từ hôm nay) hoặc thực hiện hành động dựa trên một mục bạn đã tạo trên lịch (ví dụ: bật chiến dịch vào một ngày cụ thể).
- Google Trang trình bày
- Kịch bản của bạn có thể xuất thông tin chi tiết hoặc số liệu thống kê về chiến dịch sang Google Trang trình bày để xuất bản thông tin đó ở định dạng có thể trình bày.
- Google Tasks
- Kịch bản của bạn có thể tạo danh sách lời nhắc cho các việc cần làm trong tương lai (ví dụ: chạy báo cáo hiệu suất cho chiến dịch của bạn sau hai tuần kể từ hôm nay) hoặc thực hiện các hành động dựa trên một mục bạn đã tạo trong danh sách lời nhắc (ví dụ: bật một chiến dịch vào một ngày cụ thể).
- Merchant API
- Kịch bản của bạn có thể sử dụng Merchant API để tải lên và quản lý trang thông tin sản phẩm, cũng như quản lý tài khoản Google Merchant Center. Trong tập lệnh, việc này có thể hữu ích để kiểm tra trang thông tin sản phẩm và liên kết một số sản phẩm với quảng cáo cụ thể. Merchant API có các API phụ có thể được bật riêng lẻ trong hộp thoại API nâng cao. Bạn có thể tìm hiểu thêm về cách liên kết tài khoản Google Merchant Center thông qua hướng dẫn Đăng ký làm nhà phát triển.
- Nội dung mua sắm
- Kịch bản của bạn có thể sử dụng Google Content API for Shopping để tải lên và quản lý trang thông tin sản phẩm, cũng như quản lý tài khoản Google Merchant Center. Trong tập lệnh, việc này có thể hữu ích để kiểm tra trang thông tin sản phẩm và liên kết một số sản phẩm với quảng cáo cụ thể. Lưu ý: Content API for Shopping sẽ ngừng hoạt động từ ngày 18 tháng 8 năm 2026. Thay vào đó, hãy sử dụng Merchant API được mô tả trong phần trước.
- YouTube và YouTube Analytics
- Bạn có thể truy xuất và cập nhật video, danh sách phát, v.v. cũng như dữ liệu hiệu suất của video để đưa ra quyết định đặt giá thầu.
Bật các API nâng cao
Để xem những API nào của Google có sẵn dưới dạng API nâng cao, hãy nhấp vào Advanced APIs (API nâng cao) trong thanh trình chỉnh sửa trên cùng để hiển thị hộp thoại Advanced APIs (API nâng cao). Chọn API bạn muốn bật.
Nhấp vào Lưu để lưu các lựa chọn của bạn và quay lại trình chỉnh sửa tập lệnh. Các API mới sẽ được bật cho tập lệnh của bạn và có trong danh sách tự động hoàn thành.
Các yếu tố cần cân nhắc khác
Có một số điều cần lưu ý khi làm việc với các API nâng cao.
Phần phụ thuộc
Chỉ người dùng đã tạo tập lệnh trong tài khoản mới có thể thay đổi các phần phụ thuộc API nâng cao cho tập lệnh đó.
Quyền
Khi truy cập vào các API nâng cao, tập lệnh sẽ sử dụng quyền của người dùng đã uỷ quyền cho tập lệnh. Người dùng uỷ quyền phải có quyền truy cập cần thiết vào tất cả
dữ liệu mà tập lệnh cần. Ví dụ: để sử dụng API nâng cao BigQuery, người dùng uỷ quyền phải có các quyền cần thiết đối với dự án trên đám mây Google Cloud và tập dữ liệu BigQuery mục tiêu.
Những điều cần cân nhắc đối với các tập lệnh trước tháng 5 năm 2019
Đối với các tập lệnh được tạo trước tháng 5 năm 2019, bạn có thể cần phải bật các API liên quan theo cách thủ công trong Dự án trên đám mây của Google được liên kết của tập lệnh. Bạn sẽ biết liệu tập lệnh của mình có bị ảnh hưởng hay không nếu thấy đường liên kết đến Google Cloud Console trong hộp thoại API nâng cao.
Bật các API nâng cao
Đối với các tập lệnh trước năm 2019, bạn cần bật từng API nâng cao mà bạn muốn sử dụng trong tập lệnh theo cách thủ công:
- Nhấp vào nút Advanced APIs (API nâng cao). Trong cửa sổ hộp thoại sau, hãy nhấp vào đường liên kết đến Google Cloud Console.
- Nếu dự án của bạn chưa được chọn, hãy chọn dự án đó trong danh sách thả xuống Dự án.
- Tìm các API bạn muốn sử dụng trong tập lệnh bằng cách nhập tên API vào thanh tìm kiếm.
- Chọn API trong kết quả tìm kiếm rồi nhấp vào nút "Bật" trên trang tiếp theo.
Nếu người dùng tạo tập lệnh sau đó bị xoá khỏi tài khoản, thì mọi người dùng mới cố gắng truy cập vào tập lệnh sẽ được nhắc bật lại các phần phụ thuộc API nâng cao, cũng như uỷ quyền lại cho tập lệnh.