API nâng cao

API nâng cao trong tập lệnh Google Ads cho phép 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 hơn so với việc sử dụng giao diện HTTP. 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 cung cấp các tiện ích giống như tính năng tự động hoàn thành và uỷ quyền tự động.

Các cách sử dụng có thể cho API nâng cao

Google Analytics
Bạn có thể sử dụng Google Analytics để theo dõi lưu lượng truy cập vào trang web của mình và điều chỉnh giá thầu chiến dịch cho phù hợp. Nếu liên kết một tài sản Google Analytics 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 vào trang web hoặc doanh số bán hàng đến từ Google Ads, đồng thời giúp bạn 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à tài khoản Google Ads trong trung tâm trợ giúp của chúng tôi.
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 khác là dùng việc quản lý số liệu về dữ liệu hiệu suất của tài khoản trong vài 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à các dữ liệu khác 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ủ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 trong 2 tuần kể từ hôm nay) hoặc thực hiện các hành động dựa trên 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 cho phép người dùng Google Merchant Center tải lên và quản lý trang thông tin sản phẩm cũng như quản lý các tài khoản Merchant Center của họ. Trong tập lệnh, thuộc tính này có thể hữu ích khi 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ủa bạn có thể tạo danh sách lời nhắc 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 trong vòng 2 tuần kể từ hôm nay) hoặc thực hiện các hành động dựa trên mục nhập 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 những thông tin đó ở định dạng trình bày được.

Bật API nâng cao

Để xem API nâng cao nào của Google hiện 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ở ra hộp thoại API Nâng cao. Kiểm tra các API mà bạn muốn bật.

Tiếp theo, nhấp vào đường liên kết Google API Console để hiển thị trang API Console (Bảng điều khiển API) cùng với dự án liên kết với tập lệnh của bạn; hoặc nếu chưa chọn dự án, hãy chọn dự án đó từ danh sách thả xuống Project (Dự án). Tìm kiếm 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 và chọn Enable (Bật) trên trang tiếp theo; nếu bạn thấy nút Disable (Tắt), thì tức là 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 tổng quan. Xác minh rằng tất cả API nâng cao mà bạn muốn sử dụng cho tập lệnh đều được liệt kê.

Bây giờ, hãy đóng hộp thoại Advanced API (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.

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/slide
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 để biết một số ví dụ về cách sử dụng các API này.

Cuối cùng, những điểm cần lưu ý

Có một vài điều cần lưu ý khi làm việc với API nâng cao.

Mã dự án

Mỗi tập lệnh Google Ads đều có một Mã dự án Google Cloud Platform (còn gọi là số dự án) liên kết với tập lệnh đó. Bạn có thể tìm thấy 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 sau đó người dùng đã tạo tập lệnh 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 tập lệnh và thiết lập lại các phần phụ thuộc API nâng cao. Mã dự án mới dành cho nhà phát triển của Google 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 API, một tập lệnh sẽ sử dụng quyền của người dùng đã uỷ quyền tập lệnh đó. Hãy đảm bảo rằng người dùng đã uỷ quyền 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 đảm bảo rằng người dùng đã uỷ quyền tập lệnh có các quyền cần thiết để truy cập vào tài khoản Analytics.

Điều khoản và điều kiện

Mỗi API nâng cao có thể có các Điều khoản và điều kiện riêng mà bạn nên 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 đi kèm. 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 mình 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

Một số API nâng cao yêu cầu bạn phải trả tiền để sử dụng. Các khoản thanh toán này được quản lý thông qua dự án Google Cloud Platform 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 chi tiết về cách bật tính năng thanh toán cho dự án Google Cloud Platform trong tập lệnh của bạn.