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

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

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

Để sử dụng API Search Ads 360, bạn cần có một 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:

  1. Nếu bạn chưa có Tài khoản Google, hãy tạo một tài khoản.

  2. Yêu cầu Người quản lý đại lý trên Search Ads 360 tạo 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 cần có quyền xem đối với 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 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 cấu hình Floodlight dùng chung, bạn cần có quyền chỉnh sửa đối với từng nhà quảng cáo con 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 các nhà quảng cáo con 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 đảm bảo rằng bạn có quyền chỉnh sửa đối với nhà quảng cáo đã tạo ra mã lượt nhấp đó. Nếu bạn chỉ định mã lượt nhấp qua 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àm Người dùng nhà quảng cáo có 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 có 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ả 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 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 xem Trung tâm trợ giúp của Search Ads 360 để biết hướng dẫn.

Tạo dự án Bảng điều khiển API Google và thông tin xác thực OAuth cho ứng dụng

  1. Khởi động công cụ thiết lập của Google API Console.
    Công cụ thiết lập sẽ 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.
  2. Trên trang Register your application (Đăng ký ứng dụng), hãy chọn một dự án hiện có hoặc chọn Create a project (Tạo dự án). Sau đó, hãy nhấp vào Tiếp tục.
  3. Sau khi Google API Console bật API Search Ads 360, hãy nhấp vào nút Chuyển đến thông tin xác thực.
  4. Trên trang Tạo thông tin xác thực, hãy nhập những 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 dữ liệu nào?: Dữ liệu người dùng
  5. Nhấp vào nút Tiếp theo.

    Công cụ thiết lập hiện sẽ cung cấp khả năng giúp bạn tạo ID ứng dụng khách OAuth 2.0.

  6. 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 quyền uỷ 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:

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

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

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

Nếu quyết định không sử dụng thư viện ứng dụng, bạn cần hiểu các 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 Google, nó đề cập đến việc sử dụng các động từ HTTP để truy xuất và sửa đổi bản trình bày dữ liệu do Google lưu trữ.

Trong hệ thống RESTful, tài nguyên được lưu trữ trong một kho 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), sau đó máy chủ thực hiện hành động và gửi phản hồi, thường ở dạng bản trình bày của tài nguyên đã 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. Phương thức này chỉ định một tài nguyên theo URI duy nhất trên toàn hệ thống có dạng như sau:

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

Vì mọi tài nguyên API đều có URI riêng biệt có thể truy cập HTTP, nên REST cho phép 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 tiêu chuẩn HTTP 1.1 hữu ích; vì 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 hoạt động API của Search Ads 360 có liên hệ trực tiếp đến các động từ HTTP. trong REST.

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

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

Bạn có thể thấy tóm tắt về toàn bộ URI được sử dụng cho từng thao tác được hỗ trợ trong API trong Tài liệu tham khảo về API.

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

Nếu sử dụng REST, bạn cần sử dụng định dạng JSON cho nội dung yêu cầu. Bạn có thể chỉ định rằng các phản hồi phả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, không phụ thuộc vào 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.