API Báo cáo Search Ads 360 cũ sẽ ngừng hoạt động và ngừng hoạt động từ ngày 30 tháng 6 năm 2024. Xin lưu ý rằng API Lượt chuyển đổi Search Ads 360 không bị ảnh hưởng và sẽ tiếp tục được hỗ trợ. Mọi hoạt động phát triển báo cáo mới đều phải sử dụng API Báo cáo Search Ads 360 mới.

Kể từ tháng 4 năm 2024, hệ thống sẽ trả về lỗi supportedApiVersion trong khi yêu cầu báo cáo. Xem chi tiết tại đây.

Bạn cũng nên di chuyển mọi hoạt động triển khai Search Ads 360 hiện có sang API mới. Hãy xem Bắt đầu và Hướng dẫn di chuyển API Báo cáo Search Ads 360 mới để biết thêm thông tin.

Trang này được dịch bởi Cloud Translation API.

Ứng dụng đầu tiên của bạn: Điều kiện tiên quyết

Để có thể bắt đầu lập trình ứng dụng đầu tiên của mình, bạn cần làm một số việc nếu chưa thực hiện.

Tạo Tài khoản Google và nhận quyền trong Search Ads 360

Để sử dụng API Search Ads 360, bạn cần có Tài khoản Google và các quyền thích hợp được cấp cho tài khoản đó trong Search Ads 360:

Nếu bạn chưa có Tài khoản Google, hãy tạo một tài khoản.
Yêu cầu Người quản lý đại lý của Search Ads 360 tạo một người dùng Search Ads 360 cho Tài khoản Google của bạn.

Để tải báo cáo xuống, bạn sẽ cần có quyền xem cho những nhà quảng cáo mà bạn sẽ hợp tác.

Để thêm hoặc chỉnh sửa lượt chuyển đổi, bạn sẽ cần có quyền chỉnh sửa đối với những nhà quảng cáo mà bạn sẽ hợp tác. Trong một cấu hình Floodlight dùng chung, bạn cần có quyền chỉnh sửa cho từng nhà quảng cáo phụ mà bạn muốn tải lượt chuyển đổi lên. Bạn không cần quyền truy cập vào nhà quảng cáo mẹ và bạn cũng không cần quyền truy cập vào những nhà quảng cáo phụ mà bạn không tải lượt chuyển đổi lên. Nếu bạn sử dụng mã lượt nhấp để phân bổ lượt chuyển đổi cho lượt truy cập, hãy nhớ chỉnh sửa quyền truy cập của nhà quảng cáo đã tạo mã lượt nhấp đó. Nếu bạn chỉ định một mã lượt nhấp của một nhà quảng cáo mà bạn không có quyền chỉnh sửa, thì yêu cầu đó sẽ không thành công.

Người quản lý đại lý có thể thiết lập tài khoản của bạn là Người dùng nhà quảng cáo với quyền truy cập vào một số nhà quảng cáo cụ thể hoặc thiết lập tài khoản của bạn với cấp truy cập cao hơn, chẳng hạn như Người dùng đại lý có quyền truy cập vào tất cả các nhà quảng cáo trong đại lý.

Kích hoạt Dịch vụ chuyển đổi API

Nếu bạn muốn tải dữ liệu về lượt chuyển đổi lên, thì người dùng Search Ads 360 có đặc quyền Người quản lý đại lý cần phải đăng nhập vào giao diện người dùng Search Ads 360 và kích hoạt dịch vụ chuyển đổi API. Hãy truy cập vào Trung tâm trợ giúp Search Ads 360 để xem hướng dẫn.

Tạo dự án Google API Console và thông tin đăng nhập OAuth cho ứng dụng khách của bạn

Khởi động công cụ thiết lập của Google API Console.
Công cụ thiết lập hướng dẫn bạn tạo dự án (hoặc sử dụng dự án hiện có), bật API Search Ads 360 và tạo thông tin xác thực OAuth 2.0.
Trên trang Đăng ký ứng dụng, hãy chọn một dự án hiện có hoặc chọn Tạo dự án. Sau đó, hãy nhấp vào Tiếp tục.
Sau khi bảng điều khiển API của Google bật API Search Ads 360, hãy nhấp vào nút Truy cập vào thông tin xác thực.
Trên trang Tạo thông tin xác thực, hãy nhập các thông tin sau:
- Bạn đang sử dụng API nào?: API Search Ads 360
- Bạn sẽ truy cập vào những dữ liệu nào?: Dữ liệu người dùng
Nhấp vào nút Tiếp theo.
Công cụ thiết lập hiện cung cấp để giúp bạn tạo mã ứng dụng khách OAuth 2.0.
Làm theo các bước còn lại trong công cụ thiết lập.

Cài đặt sa360Api.py

Search Ads 360 cung cấp một tập lệnh tiện ích để hỗ trợ quá trình thiết lập ủy quyền. Bạn cũng có thể sử dụng tập lệnh này để gửi và nhận dữ liệu ở định dạng JSON, nếu muốn thử gửi và nhận dữ liệu trước khi thiết kế và viết một ứng dụng đầy đủ. Bạn có thể sao chép nhiều ví dụ về JSON trong trang web tài liệu này và nhập trực tiếp các ví dụ đó vào tập lệnh.

Cách cài đặt tập lệnh:

Cài đặt Python 2.7.
Tập lệnh không hoạt động với Python 3.x.
Cài đặt cURL.
Tải tệp sa360Api.zip xuống.
Trích xuất sa360Api.py từ sa360Api.zip.
Đặt sa360Api.py thành tệp thực thi.

Tìm hiểu kiến thức cơ bản về REST

Có hai cách để gọi API:

Sử dụng thư viện ứng dụng.
Gửi yêu cầu HTTP và phân tích cú pháp các phản hồi.

Nếu quyết định không sử dụng thư viện ứng dụng, bạn sẽ cần hiểu những kiến thức cơ bản về REST.

REST là một kiểu kiến trúc phần mềm cung cấp một phương pháp nhất quán thuận tiện để yêu cầu và sửa đổi dữ liệu.

Thuật ngữ REST là tên viết tắt của "Đại diện chuyển trạng thái". Trong ngữ cảnh của API Google, thuật ngữ này đề cập đến việc sử dụng động từ HTTP để truy xuất và sửa đổi bản trình bày dữ liệu được Google lưu trữ.

Trong hệ thống RESTful, tài nguyên được lưu trữ trong kho lưu trữ dữ liệu; máy khách gửi yêu cầu rằng máy chủ thực hiện một hành động cụ thể (chẳng hạn như tạo, truy xuất, cập nhật hoặc xóa tài nguyên) và máy chủ thực hiện hành động đó và gửi phản hồi, thường ở dạng đại diện cho tài nguyên đã chỉ định.

Trong API RESTful của Google, ứng dụng chỉ định một thao tác bằng cách sử dụng động từ HTTP như POST, GET, PUT hoặc DELETE. Hàm này chỉ định tài nguyên theo một URI độc nhất trên toàn cầu có dạng như sau:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

Vì tất cả tài nguyên API đều có các URI có thể truy cập HTTP duy nhất, nên REST cho phép lưu vào bộ nhớ đệm dữ liệu và được tối ưu hoá để hoạt động với cơ sở hạ tầng phân tán của web.

Bạn có thể thấy định nghĩa về phương thức trong tài liệu về các tiêu chuẩn HTTP 1.1; các định nghĩa này bao gồm thông số kỹ thuật cho GET, POST, PUT và DELETE.

REST trong API Search Ads 360

Các thao tác API Search Ads 360 sẽ ánh xạ trực tiếp đến động từ HTTP trong REST.

Định dạng cụ thể cho các URI API của Search Ads 360 là:

https://www.googleapis.com/doubleclicksearch/v2/resourcePath?parameters

Tập hợp đầy đủ các URI được sử dụng cho từng toán tử được hỗ trợ trong API được tóm tắt trong Tài liệu tham khảo API.

Tìm hiểu kiến thức cơ bản về JSON

Nếu sử dụng REST, bạn cần phải sử dụng định dạng JSON cho nội dung yêu cầu. Bạn có thể chỉ định nội dung phản hồi ở định dạng JSON hoặc CSV.

JSON (Ký hiệu đối tượng JavaScript) là một định dạng dữ liệu phổ biến, độc lập về ngôn ngữ, cung cấp bản trình bày văn bản đơn giản của các cấu trúc dữ liệu tùy ý. Để biết thêm thông tin, hãy xem json.org.