Các API nâng cao trong tập lệnh Google Ads cho phép các nhà phát triển có kinh nghiệm 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 của các API đó. Bạn 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 đến những tiện ích tương tự như tính năng tự động hoàn thành và uỷ quyền tự động.
Các trường hợp có thể sử dụng API nâng cao
- Google Analytics 4
- Bạn có thể sử dụng Google Analytics 4 để theo dõi lưu lượng truy cập đến trang web của mình và điều chỉnh giá thầu của chiến dịch cho phù hợp. Nếu liên kết một tài sản Google Analytics 4 với tài khoản Google Ads, bạn cũng có thể phân tích hoạt động của khách hàng trên trang web của mình. Thông tin này có thể cho biết lưu lượng truy cập trang web hoặc doanh số mà Google Ads mang đến cho bạn, nhờ đó, bạn có thể cải thiện quảng cáo và trang web của mình. Bạn có thể tìm hiểu thêm về cách liên kết tài khoản Analytics với tài khoản Google Ads thông qua Google Analytics 4.
- 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 trường hợp sử dụng khác là xử lý số liệu về dữ liệu hiệu suất của tài khoản trong nhiều năm.
- 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.
- Lịch Google
- Tập lệnh có thể tạo sự kiện cho các tác vụ trong tương lai (ví dụ: chạy báo cáo hiệu suất cho các chiến dịch của bạn sau 2 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 mà bạn đã tạo trên lịch của mình (ví dụ: bật một chiến dịch vào một ngày cụ thể).
- Nội dung mua sắm
- Tập lệnh của bạn có thể sử dụng Google Content API for Shopping trong Apps Script. API này giúp người dùng Google Merchant Center có thể 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 Merchant Center. Trong tập lệnh, bạn có thể dùng thông tin này để kiểm tra trang thông tin sản phẩm và liên kết các sản phẩm cụ thể với các quảng cáo cụ thể.
- Google Tasks
- Tập lệnh 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 các chiến dịch của bạn sau 2 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 mà 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ể).
- Google Trang trình bày
- Tập lệnh 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.
Bật 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 nút API nâng cao trên thanh trình chỉnh sửa ở trên cùng.
Thao tác này sẽ mở hộp thoại API nâng cao. Đánh dấu vào các API bạn muốn bật.
Tiếp theo, hãy nhấp vào đường liên kết Google API Console để mở trang API Console trong Bảng điều khiển, với dự án được liên kết với tập lệnh của bạn; hoặc 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 kiếm các API mà 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.
Trong kết quả tìm kiếm, hãy chọn API, rồi chọn Bật trên trang tiếp theo; nếu bạn thấy nút Tắt, thì API này đã được bật. Lặp lại thao tác này cho từng API mà bạn muốn bật.
Để xem danh sách các API đã bật cho dự án, hãy chọn trang Trang tổng quan. Xác minh rằng tất cả các API nâng cao mà bạn muốn dùng cho tập lệnh đều được liệt kê.
Bây giờ, hãy đóng hộp thoại Advanced APIs (API nâng cao) để quay lại trình chỉnh sửa. 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 API hiện có
Bạn có thể sử dụng các API sau:
| Tên API | Tài liệu |
|---|---|
| Google Analytics | https://developers.google.com/apps-script/advanced/analytics |
| Google BigQuery | https://developers.google.com/apps-script/advanced/bigquery |
| Lịch Google | https://developers.google.com/apps-script/advanced/calendar |
| Google Trang trình bày | https://developers.google.com/apps-script/advanced/slides |
| Google Tasks | https://developers.google.com/apps-script/advanced/tasks |
| Nội dung mua sắm | 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 |
Bạn cũng có thể tham khảo trang đoạn mã của chúng tôi để xem một số ví dụ về cách sử dụng các API này.
Những điểm cần cân nhắc cuối cùng
Có một số điều cần lưu ý khi sử dụng Advanced API.
Mã dự án
Mỗi tập lệnh Google Ads đều có một Mã dự án trên Google Cloud (còn gọi là số dự án) được liên kết. Bạn có thể tìm thấy mã số dự án của tập lệnh bằng cách mở trang Google API Console trong hộp thoại API nâng cao. Mã dự án này được tạo khi bạn tạo tập lệnh và được liên kết với người dùng đã tạo tập lệnh Google Ads. Nếu người dùng tạo tập lệnh sau đó bị xoá khỏi tài khoản, thì người dùng đang cố gắng truy cập vào tập lệnh sẽ được nhắc uỷ quyền lại cho tập lệnh và thiết lập lại các phần phụ thuộc API nâng cao. Một mã dự án mới của Google cho nhà phát triển cũng sẽ được tạo và bạn sẽ cần thiết lập lại các API nâng cao như đã giải thích trước đó trong tài liệu này.
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, một tập lệnh sẽ sử dụng các quyền của người dùng đã uỷ quyền cho tập lệnh đó. Đảm bảo rằng người dùng đã uỷ quyền cho tập lệnh có quyền truy cập cần thiết vào tất cả các API nâng cao đang được sử dụng cũng như dữ liệu mà tập lệnh cần. Nếu bạn đang sử dụng API Google Analytics, hãy xác minh rằng người dùng đã uỷ quyền cho tập lệnh có các quyền cần thiết đối với tài khoản Analytics đang được truy cập.
Ðiều khoản và điều kiện
Mỗi API nâng cao có thể có Điều khoản và điều kiện riêng mà bạn phải chấp nhận khi bật API đó trong Google API Console.
Hạn mức
Hầu hết các API nâng cao đều có hạn mức miễn phí hằng ngày. Sau khi tập lệnh của bạn vượt quá hạn mức này, API sẽ ngừng hoạt động cho đến khi bạn yêu cầu thêm dữ liệu hoặc hạn mức miễn phí được bổ sung. Bạn có thể theo dõi hạn mức mà tập lệnh của bạn sử dụng bằng cách mở Google API Console cho tập lệnh đó trong hộp thoại API nâng cao. Google API Console cũng cung cấp cho bạn cách yêu cầu hạn mức bổ sung cho API.
Thanh toán
Bạn phải trả phí sử dụng một số API nâng cao. Các khoản thanh toán này được quản lý thông qua dự án Google Cloud liên kết với tập lệnh của bạn, chứ không phải thông qua Google Ads. Hãy xem tài liệu của chúng tôi để biết thêm thông tin về cách bật tính năng thanh toán cho dự án Google Cloud của tập lệnh.