Câu hỏi thường gặp

API GBP là gì?

API Trang doanh nghiệp là các giao diện lập trình cho phép nhà phát triển viết ứng dụng để quản lý tài khoản Trang doanh nghiệp và dữ liệu vị trí của họ. API này cho phép người bán hoặc người đại diện của họ quản lý cách dữ liệu của họ xuất hiện trên Google và kiểm soát ai là người cùng quản lý dữ liệu của họ. Bạn cũng có thể quản lý dữ liệu do người dùng tạo, chẳng hạn như ảnh, bài đăng và bài đánh giá, thông qua API.

API Trang doanh nghiệp cung cấp các tính năng gần giống như giao diện người dùng của Trang doanh nghiệp, cộng với một số tính năng bổ sung dành riêng cho các API này. Người dùng API có thể kỳ vọng các bản cập nhật của Google sẽ diễn ra giống như với người dùng giao diện người dùng.

Ai có thể truy cập vào các API của GBP?

API GBP không được cung cấp công khai. Người dùng phải yêu cầu quyền truy cập vào API GBP để sử dụng các API đó. Mọi cá nhân hoặc công ty có thể chứng minh lý do kinh doanh hợp pháp để truy cập vào API GBP đều được phê duyệt cho quyền truy cập. Dưới đây là một số đề xuất để chứng minh tính hợp pháp của doanh nghiệp:

  • Sử dụng địa chỉ email doanh nghiệp hợp lệ được liên kết với miền doanh nghiệp của bạn.
  • Đảm bảo rằng trang web của doanh nghiệp đã được cập nhật và đang hoạt động.

Việc có quyền truy cập vào API GBP có cho phép người dùng truy vấn bất kỳ dữ liệu nào trong Trang doanh nghiệp trên Google không?

Không. Ngay cả khi có quyền sử dụng API GBP, bạn cũng không được truy vấn dữ liệu Trang doanh nghiệp trên Google trừ phi bạn có quyền truy cập vào Trang doanh nghiệp trên Google đó.

Những chính sách nào có liên quan cho người dùng API Trang doanh nghiệp trên Google?

Đối tác cần phải tuân thủ chính sách về Trang doanh nghiệp trên Google cũng như tất cả chính sách cũng như điều khoản và điều kiện về API.

Người dùng truy cập vào API Trang doanh nghiệp trên Google bằng cách nào?

Để tạo thành công ứng dụng đầu tiên, bạn phải hoàn tất các điều kiện tiên quyết sau:

  1. Tạo Tài khoản Google.
  2. Dùng thử Trang doanh nghiệp.
  3. Tạo dự án trong Google API Console.
  4. Yêu cầu quyền truy cập vào API: Các yêu cầu được xem xét trong vòng 14 ngày.

Làm cách nào để người dùng truy cập vào một API nhất định trong API Trang doanh nghiệp trên Google?

Có 8 API liên kết với Trang doanh nghiệp phải được bật trong Google API Console:

  • Google Doanh nghiệp của tôi API 4.9, bao gồm các lệnh gọi API tính năng quan trọng sau đây:
    • FoodMenus
    • Media
    • Reviews
    • LocalPosts
  • API Quản lý tài khoản doanh nghiệp của tôi
  • API Phòng cho thuê của doanh nghiệp của tôi
  • API My Business Place Actions
  • 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
  • API Hiệu suất Trang doanh nghiệp

Nếu ứng dụng yêu cầu quyền truy cập của người dùng được phê duyệt, thì họ sẽ được cấp một hạn mức mặc định chuẩn cho cả 8 API.

Quyền truy cập vào API GBP hoạt động như thế nào?

Quyền truy cập của API GBP được cấp ở cấp dự án trên Google Cloud. Nếu người dùng A đã đăng ký cấp quyền truy cập vào API Trang doanh nghiệp trên Google cho dự án # – 12345678, thì quyền truy cập đó sẽ được cấp cho dự án # – 12345678. Do đó, bất kỳ người dùng nào (bao gồm cả người dùng A có quyền truy cập vào dự án Google Cloud) đều có thể thực hiện lệnh gọi đến các API Trang doanh nghiệp trên Google. Đối tác phải kiểm soát quyền truy cập vào dự án Google Cloud khi cần có quyền truy cập để tránh sử dụng sai mục đích.

Bạn có bản tóm tắt về các API và chức năng mẫu không?

Hãy tham khảo bảng sau để tìm hiểu về các API và chức năng của chúng.

API Tài liệu tham khảo Ví dụ về khả năng
Account Management API (API Quản lý tài khoản) Tài liệu
  • Quản lý quyền truy cập vào một vị trí.
  • Tạo một tài khoản có tên và loại đã chỉ định trong phần tử mẹ đã cho.
  • Liệt kê tất cả tài khoản của người dùng đã xác thực.
  • Liệt kê các lời mời đang chờ xử lý cho tài khoản được chỉ định.
  • Di chuyển vị trí từ một tài khoản mà người dùng sở hữu sang một tài khoản khác.
  • Cập nhật quản trị viên cho vị trí được chỉ định.
API Thông tin doanh nghiệp Tài liệu
  • API thông tin doanh nghiệp cho phép quản lý vòng đời của hồ sơ và thêm hoặc quản lý thông tin doanh nghiệp trên GBP.
  • Cho phép người bán nhận, tạo, cập nhật hoặc xoá trang doanh nghiệp trên Google.
  • Cho phép người bán nhận hoặc cập nhật các thuộc tính của trang doanh nghiệp.
  • Cho phép người bán nhận hoặc tìm kiếm chuỗi, danh mục trang doanh nghiệp.
API Phòng cho thuê Tài liệu
  • Cho phép quản lý dữ liệu về cơ sở lưu trú (ví dụ: tiện nghi của cơ sở lưu trú và chính sách dành cho doanh nghiệp trên Google). API này dành riêng cho những doanh nghiệp cung cấp dịch vụ lưu trú, chẳng hạn như khách sạn. API Phòng cho thuê giúp nhà phát triển cập nhật các đặc điểm của cơ sở lưu trú trong Trang doanh nghiệp trên Google.
API Hành động với địa điểm Tài liệu
  • Cho phép quản lý các đường liên kết đến hành động liên quan đến địa điểm trên doanh nghiệp.
  • Chuyển hướng người dùng để thực hiện các hành động như đặt lịch hẹn, đặt bàn và đặt dịch vụ giao đồ ăn.
API Thông báo Tài liệu
  • Cho phép quản lý chế độ cài đặt thông báo cho các tài khoản được chỉ định.
API Xác minh Tài liệu
  • Bắt đầu quy trình xác minh cho một vị trí.
  • Báo cáo tất cả các phương thức xác minh đủ điều kiện cho một vị trí bằng một ngôn ngữ cụ thể.
API Hỏi và đáp Tài liệu
  • Cho phép quản lý câu hỏi và câu trả lời về một vị trí.
API Hiệu suất Trang doanh nghiệp Tài liệu
  • Cho phép người bán tìm nạp thông tin chi tiết về hiệu suất liên quan đến trang thông tin doanh nghiệp của họ trên Google.
  • Thông tin chi tiết bao gồm số lượt hiển thị của doanh nghiệp, số yêu cầu xem đường đi, số lượt nhấp vào nút gọi, số lượt nhấp vào trang web, số lượt đặt chỗ, số đơn đặt món, số lượt tương tác với thực đơn, v.v.
API Nội dung nghe nhìn Tài liệu
  • Cho phép nhà phát triển API tải ảnh và video lên cho một trang doanh nghiệp.
API Bài đánh giá Tài liệu
  • Cho phép người bán xem bài đánh giá và trả lời bài đánh giá trên trang doanh nghiệp.
Local Post API (API Bài đăng địa phương) Tài liệu
  • Cho phép người bán nhận, tạo hoặc cập nhật bài đăng liên quan đến địa phương.
API FoodMenus Tài liệu
  • Cho phép người bán nhận, tạo hoặc cập nhật thực đơn món ăn cho trang doanh nghiệp.

Làm cách nào để đối tác thiết lập cấu trúc tài khoản để sử dụng API của GBP?

Nếu bạn là đối tác bên thứ ba phụ trách quản lý trang thông tin cho các doanh nghiệp:

Các doanh nghiệp uỷ quyền cho đối tác API của GBP quản lý trang thông tin doanh nghiệp bằng cách nào?

Các doanh nghiệp cấp quyền truy cập cho đối tác bên thứ ba theo 2 cách:

  • Thiết lập OAuth: Tham khảo hướng dẫn này để hiểu cách các nền tảng đối tác bên thứ ba sử dụng thông tin đăng nhập của người bán để chỉnh sửa và truy cập vào dữ liệu Trang doanh nghiệp trên Google thay mặt cho người bán hoặc doanh nghiệp.

  • Quyền truy cập của chủ sở hữu hoặc người quản lý: Nếu người bán thêm một đối tác bên thứ ba làm người quản lý Trang doanh nghiệp trên Google và người này phải là chủ sở hữu chính của Trang doanh nghiệp trên Google, thì đối tác bên thứ ba không cần phải sử dụng thông tin đăng nhập của người bán để sử dụng API GBP nhằm chỉnh sửa và truy cập vào dữ liệu GBP.

    Lưu ý: Đối tác bên thứ ba không nên tự thêm mình làm chủ sở hữu GBP mà chỉ nên tự thêm chính mình làm người quản lý.

Nếu một doanh nghiệp có hơn 10 địa điểm, thì có cách nào để xác minh hàng loạt không?

Có. Bạn có thể yêu cầu xác minh hàng loạt cho hơn 10 trang doanh nghiệp. Sau khi xác minh, bạn có thể quản lý các vị trí của chuỗi cửa hàng đã phát hành bằng API Trang doanh nghiệp theo cách tương tự như cách quản lý các vị trí khác, trừ một số trường hợp ngoại lệ. Ví dụ: người quản lý địa điểm được xử lý theo các cách khác nhau và họ có thể tự thêm mình vào các địa điểm nhượng quyền.

Hạn mức cho các API khác nhau là bao nhiêu?

Hạn mức tiêu chuẩn được liệt kê trong phần Hạn mức sử dụng. Nếu cần hạn mức cao hơn, bạn có thể gửi yêu cầu hạn mức chuẩn.

Tôi có thể yêu cầu hạn mức bao nhiêu?

Hạn mức là một tài nguyên hạn chế. Nhóm hỗ trợ API GBP xác định xem bạn có đủ điều kiện sử dụng yêu cầu tăng hạn mức hay không bằng cách xác nhận mức sử dụng hạn mức trước đây của bạn. Nếu mức sử dụng hạn mức trung bình của bạn ít hơn 70% hạn mức hiện tại, thì bạn có thể bị từ chối nếu không được tăng hạn mức nữa.

Đối tác API của GBP có thể tạo tài khoản thử nghiệm cho sản phẩm không?

Không. Rất tiếc là không có cách trực tiếp nào để tạo một trang thông tin GBP giả mạo trong phiên bản chính thức, thông qua giao diện người dùng hoặc API của GBP và thử nghiệm trên đó.

Hầu hết các trang thông tin giả mạo được tạo ra đều bị nhóm kiểm duyệt của chúng tôi gắn cờ và tạm ngưng. Bạn nên sử dụng danh sách khách hàng và làm việc với danh sách đó sau giờ làm việc (miễn là bạn không thay đổi bất kỳ thông tin chính nào của danh sách, chẳng hạn như tên, địa chỉ, danh mục) hoặc bạn tạo một trang thông tin cho trụ sở công ty. Nếu muốn kiểm thử một phản hồi của API để xác minh một trang thông tin hoặc bất kỳ hành động nào khác cần đến trang thông tin chính thức, thì bạn có thể sử dụng tính năng bắt chước phản hồi của API.