Để có thể bắt đầu lập trình cho ứ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
Bạn cần có một Tài khoản Google để tạo một dự án trong Google API Console. Nếu đã có tài khoản thì bạn đã hoàn tất.
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 đã sử dụng Báo cáo trải nghiệm quảng cáo của Google và bạn đã quen thuộc với các khái niệm lập trình web cũng như đị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, hãy thử giao diện người dùng trước khi bắt đầu lập trình.
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 cho Google biết về khách hàng của mình và kích hoạt quyền truy cập vào API này. Bạn thực hiện việc này bằng cách sử dụng Google API Console để tạo dự án. Dự án này là một tập hợp được đặt tên theo các tùy chọn cài đặt và thông tin truy cập API, đồng thời đăng ký ứng dụng của bạn.
Tìm hiểu thông tin 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 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 sẽ cần tìm hiểu thông tin cơ bản về REST.
REST là một kiểu kiến trúc phần mềm cung cấp cách tiếp cận thuận tiện và nhất quán để yêu cầu và sửa đổi dữ liệu.
Thuật ngữ REST là viết tắt của "Representational State Transfer (dụ thể trạng thái đại diện)." Trong bối cảnh của Google API, 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; ứng dụng 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á 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 trình bày tài nguyên đã chỉ định.
Trong các API RESTful của Google, ứng dụng khách chỉ định một hành động bằng cách sử dụng động từ HTTP như POST, GET, PUT hoặc DELETE. Công cụ này chỉ định tài nguyên theo URI duy nhất trên toàn cầu có dạng sau:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Vì tất cả tài nguyên API đều có các URI riêng biệt có thể truy cập được, nên REST cho phép việc lưu 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 phối 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 chuẩn HTTP 1.1 hữu ích, bao gồm cả các thông số kỹ thuậ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 liên kết trực tiếp với các động từ HTTP 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
Tập hợp đầy đủ các URI được sử dụng cho từng thao tác được hỗ trợ trong API được tóm tắt trong tài liệu Tài liệu tham khảo API về báo cáo trải nghiệm quảng cáo của Google.
Tìm hiểu các khái niệm 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 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.