Nếu chưa bắt đầu thực hiện những điều sau đây, bạn hãy làm ngay trước khi có thể bắt đầu mã hoá ứng dụng đầu tiên của mình.
Tạo tài khoản Google
Bạn cần có một Tài khoản Google để tạo dự án trong Google API Console. Nếu đã có tài khoản thì bạn có thể bỏ qua bước này.
Bạn cũng nên có một Tài khoản Google riêng cho mục đích thử nghiệm.
Dùng thử Báo cáo trải nghiệm quảng cáo của Google
Tài liệu API này giả định rằng bạn đã từng sử dụng Báo cáo trải nghiệm quảng cáo của Google và đã quen thuộc với các khái niệm lập trình web và định dạng dữ liệu web.
Nếu bạn chưa từng sử dụng Báo cáo trải nghiệm quảng cáo của Google, thì hãy thử giao diện người dùng trước khi bắt đầu mã hoá.
Tạo một dự án cho ứng dụng của bạn
Trước khi có thể gửi yêu cầu tới Báo cáo trải nghiệm quảng cáo của Google, bạn cần thông báo cho Google về khách hàng của mình và kích hoạt quyền truy cập vào API. Bạn có thể làm điều này bằng cách sử dụng Google API Console để tạo dự án (một tập hợp các chế độ cài đặt được đặt tên và thông tin truy cập API), sau đó đăng ký ứng dụng của bạn.
Tìm hiểu kiến thức cơ bản về REST
Có hai cách để gọi API:
- Gửi yêu cầu HTTP và phân tích cú pháp các phản hồi.
- Sử dụng thư viện ứng dụng.
Nếu quyết định không sử dụng thư viện ứng dụng, bạn cần nắm được 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 mang lại cách tiếp cận thuận tiện và nhất quán trong việc yêu cầu và sửa đổi dữ liệu.
Cụm từ REST là viết tắt của "Chuyển giao Trạng thái Trình bày". Trong ngữ cảnh của API của Google, cụm từ này đề cập đến việc sử dụng các động từ HTTP để truy xuất và sửa đổi các dạng trình bày của dữ liệu do Google lưu trữ.
Trong hệ thống RESTful, các tài nguyên được lưu trữ trong một kho dữ liệu; một máy khách gửi yêu cầu để 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 xoá một tài nguyên), rồi máy chủ thực hiện hành động đó và gửi phản hồi, thường ở dạng một bản trình bày của tài nguyên được chỉ định.
Trong API RESTful của Google, ứng dụng chỉ định một hành động bằng cách sử dụng động từ HTTP như POST, GET, PUT hoặc DELETE. Nó chỉ định một tài nguyên bằng một URI duy 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ả cá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 việc lưu trữ dữ liệu vào bộ nhớ đệm và được tối ưu hoá để hoạt động với cơ sở hạ tầng phân tán của trang web.
Bạn có thể thấy định nghĩa về phương thức trong tài liệu về các chuẩn HTTP 1.1 hữu ích; vì các định nghĩa này bao gồm nội dung đặc tả cho GET, POST, PUT và DELETE.
REST trong API Báo cáo trải nghiệm quảng cáo của Google
Các hoạt động của API Báo cáo trải nghiệm quảng cáo của Google có liên hệ trực tiếp đến các động từ HTTP trong REST.
Các định dạng cụ thể cho URI API Báo cáo trải nghiệm quảng cáo của Google là:
https://adexperiencereport.googleapis.com/v1/resourcePath?parameters
Bạn có thể xem tóm tắt về toàn bộ URI được dùng cho từng thao tác được hỗ trợ trong API trong tài liệu Tài liệu tham khảo về API Báo cáo trải nghiệm quảng cáo của Google.
Tìm hiểu kiến thức cơ bản về JSON
API Báo cáo trải nghiệm quảng cáo của Google trả về dữ liệu ở định dạng JSON.
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 phần trình bày văn bản đơn giản của các cấu trúc dữ liệu tuỳ ý. Để biết thêm thông tin, hãy xem json.org.