Để tiếp tục, hãy đảm bảo bạn đã hoàn thành các bước trong Điều kiện tiên quyết và chúng tôi đã phê duyệt quyền truy cập vào API Trang doanh nghiệp cho dự án của bạn.
Bật các API
Có 8 API liên kết với Trang doanh nghiệp phải được bật trong Google API Console:
- API Google Doanh nghiệp của tôi
- API Quản lý tài khoản doanh nghiệp của tôi
- API Phòng cho thuê doanh nghiệp của tôi
- API Hành động tại địa điểm doanh nghiệp của tôi
- API Thông báo về doanh nghiệp của tôi
- API Xác minh doanh nghiệp của tôi
- API Thông tin doanh nghiệp của tôi
- API Hỏi và đáp về doanh nghiệp của tôi
Bật API
Nếu đã hoàn thành tất cả Điều kiện tiên quyết và được cấp quyền truy cập vào API nhưng vẫn không thể sử dụng lối tắt được cung cấp, bạn có thể bật API theo cách thủ công theo các bước sau.
Để bật API cho dự án, hãy làm như sau:
- Mở Thư viện API trong Google API Console. Nếu được nhắc, hãy chọn một dự án hoặc tạo dự án mới. Thư viện API liệt kê tất cả API có sẵn, được nhóm theo nhóm sản phẩm và mức độ phổ biến.
- Nếu API bạn muốn chọn không hiển thị trong danh sách, hãy sử dụng chức năng tìm kiếm để tìm API đó.
- Chọn API bạn muốn bật, sau đó nhấp vào nút Enable (Bật).
- Nếu bạn nhận được một lời nhắc, hãy bật tính năng thanh toán.
- Nếu bạn nhận được một lời nhắc, vui lòng chấp nhận Điều khoản dịch vụ của API.
Nếu bạn là người dùng Google Workspace, hãy xác nhận rằng Trang doanh nghiệp trên Google đã được bật cho tài khoản của bạn trong tổ chức của bạn trên Google Workspace. Bạn sẽ gặp phải lỗi "lỗi 403 - PERMISSION DENIED" khi sử dụng API GBP nếu Trang doanh nghiệp trên Google cho tài khoản của bạn trong tổ chức của bạn trên Google Workspace bị tắt.
Yêu cầu mã ứng dụng khách OAuth 2.0
Vì ứng dụng của bạn truy cập vào dữ liệu được bảo vệ và không công khai, nên bạn cần có mã ứng dụng khách OAuth 2.0. Điều này cho phép ứng dụng của bạn yêu cầu được cho phép truy cập vào dữ liệu vị trí của tổ chức thay mặt người dùng ứng dụng.
Ứng dụng của bạn phải gửi mã thông báo OAuth 2.0 kèm theo mọi yêu cầu API Trang doanh nghiệp truy cập vào dữ liệu riêng tư của người dùng.
Nếu bạn chưa thực hiện việc này, hãy chuyển đến phần "Thông tin xác thực" trong Bảng điều khiển API của Google rồi nhấp vào Tạo thông tin xác thực > Mã ứng dụng khách OAuth để tạo thông tin xác thực OAuth 2.0. Sau khi tạo thông tin xác thực, bạn có thể thấy mã ứng dụng khách của mình trên trang Thông tin xác thực. Nhấp vào mã ứng dụng khách để xem thông tin chi tiết, chẳng hạn như mật khẩu ứng dụng khách, URI chuyển hướng, địa chỉ nguồn gốc JavaScript và địa chỉ email.
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 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 tìm hiểu những kiến thức cơ bản về REST.
REST là một kiểu cấu trúc phần mềm cung cấp phương pháp 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 "Dịch vụ chuyển trạng thái đại diện". Trong ngữ cảnh của Google API, API này đề cập đến việc sử dụng các động từ HTTP để truy xuất và sửa đổi các bản trình bày dữ liệu do Google lưu trữ.
Hệ thống RESTful lưu trữ tài nguyên trong một kho dữ liệu. Ứng dụng sẽ gửi yêu cầu để máy chủ thực hiện một thao tác 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ủ sẽ thực hiện thao tác đó và gửi phản hồi. Phản hồi đó thường ở dạng một đại diện của tài nguyên được chỉ định.
Trong các API RESTful của Google, ứng dụng chỉ định một thao tác bằng động từ HTTP, chẳng hạn như GET, POST, PUT hoặc DELETE. Ứng dụng chỉ định tài nguyên bằng một giá trị nhận dạng tài nguyên đồng nhất (URI) duy nhất trên toàn cầu có dạng sau:
https://apiName.googleapis.com/apiVersion/resourcePath?parameters
Vì tất cả các tài nguyên API đều có các URI duy nhấ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 phương thức trong tài liệu về các tiêu chuẩn HTTP 1.1 hữu ích. Các thông số này bao gồm thông số kỹ thuật cho GET, POST, PUT và DELETE.
REST trong API Trang doanh nghiệp
Các hoạt động của API Trang doanh nghiệp liên kết trực tiếp với động từ HTTP REST.
Định dạng cụ thể của API Trang doanh nghiệp được thể hiện trong URI sau:
https://apiName.googleapis.com/apiVersion/resourcePath?parameters
Tập hợp đầy đủ URI dùng cho từng thao tác được hỗ trợ trong API sẽ xuất hiện trong tài liệu Tài liệu tham khảo về API Trang doanh nghiệp.
Đường dẫn tài nguyên sẽ khác nhau tuỳ theo điểm cuối.
Chẳng hạn, đường dẫn tài nguyên đến một tài khoản sẽ xuất hiện như trong ví dụ sau:
accounts/accountId
Đường dẫn tài nguyên cho một vị trí xuất hiện ở dạng sau:
locations/locationId
Tìm hiểu kiến thức cơ bản về JSON
API Trang doanh nghiệp trả về dữ liệu ở định dạng JSON.
JavaScript Object Notation (JSON) 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 tuỳ ý. Để biết thêm thông tin, hãy xem json.org.
Tạo một yêu cầu HTTP đơn giản
Bạn có thể sử dụng Playground 2.0 để thử nghiệm với các API Trang doanh nghiệp. Vì API Trang doanh nghiệp không phải là API công khai nên bạn cần thực hiện thêm vài bước để sử dụng API này trong Playground. Bạn cần có mã ứng dụng khách để ứng dụng web có thể tiếp tục.
- Chuyển đến Google API Console và mở dự án của bạn. Nếu bạn chưa có mã ứng dụng khách OAuth cho các ứng dụng web, hãy tạo ngay mã ứng dụng:
- Trong danh sách thả xuống Tạo thông tin xác thực, hãy chọn Mã ứng dụng khách OAuth.
- Đối với Loại ứng dụng, hãy nhấp vào Ứng dụng web.
Thêm mã sau đây làm URI chuyển hướng hợp lệ:
https://developers.google.com/oauthplayground
- Nhấp vào Tạo.
- Sao chép mã ứng dụng khách vào bảng nhớ tạm.
- Truy cập vào Play Playground 2.0.
- Nhấp vào biểu tượng bánh răng để mở các tuỳ chọn cấu hình và thực hiện các thay đổi sau:
- Đặt quy trình OAuth thành phía máy khách.
- Chọn Sử dụng thông tin xác thực OAuth của riêng bạn.
- Dán mã ứng dụng khách OAuth.
- Đóng các lựa chọn cấu hình.
Trong "Bước 1 – Chọn và cho phép API", hãy dán phạm vi sau đây cho API Trang doanh nghiệp vào trường Nhập phạm vi của riêng bạn:
https://www.googleapis.com/auth/business.manage
- Nhấp vào Uỷ quyền API.
- Nhấp vào Chấp nhận khi được nhắc.
-
Trong "Bước 2 – Định cấu hình yêu cầu cho API", hãy dán URI sau vào trường URI yêu cầu:
https://mybusinessaccountmanagement.googleapis.com/v1/accounts
- Nhấp vào Gửi yêu cầu. Phản hồi phải hiển thị trạng thái
200 OK.
Để biết thêm thông tin về cách đưa ra nhiều loại yêu cầu, hãy xem Tài liệu tham khảo về API Trang doanh nghiệp.
Thư viện ứng dụng
Thư viện ứng dụng của API Trang doanh nghiệp hỗ trợ chức năng của API Trang doanh nghiệp. Các API này cung cấp chức năng chung cho tất cả API của Google, chẳng hạn như truyền tải HTTP, xử lý lỗi, xác thực và phân tích cú pháp JSON.
Để tải thư viện ứng dụng xuống, hãy xem phần Thư viện.