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í. API 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ọ được trình bày trên Google và kiểm soát những 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 các 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 thêm một số tính năng dành riêng cho các API này. Người dùng API có thể mong đợi các bản cập nhật của Google sẽ diễn ra giống như đối với người dùng giao diện người dùng.

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

API GBP không được 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 các API GBP đều được phê duyệt quyền truy cập. Sau đâ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 truy cập vào các API Trang doanh nghiệp trên Google, bạn cũng không thể 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 cụ thể đó trên Google.

Các chính sách liên quan cho người dùng API GBP là gì?

Đối tác cần phải tuân thủ chính sách về Trang doanh nghiệp trên Google cùng với 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 có thể truy cập vào API GBP bằng cách nào?

Để tạo thành công ứng dụng đầu tiên của mình, 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 Bảng điều khiển API của Google.
  4. Yêu cầu quyền truy cập vào API: Các yêu cầu sẽ được xem xét trong vòng 14 ngày.

Người dùng có thể truy cập vào một API nhất định trong API GBP bằng cách nào?

Có 8 API liên kết với Trang doanh nghiệp mà bạn phải bật trong Google API Console:

  • API Google Doanh nghiệp của tôi phiên bản 4.9, bao gồm các lệnh gọi API tính năng quan trọng sau:
    • FoodMenus
    • Media
    • Reviews
    • LocalPosts
  • My Business Account Management API
  • 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
  • My Business Business Information API
  • API Hỏi đáp của Doanh nghiệp của tôi
  • API hiệu suất của Trang doanh nghiệp

Nếu đơn đăng ký 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 hạn mức mặc định tiêu 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 vào API GBP được cấp ở cấp dự án Google Cloud. Nếu người dùng A đã đăng ký 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 đó, mọi người dùng, 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. Để tránh việc sử dụng sai mục đích, đối tác phải kiểm soát quyền truy cập vào dự án Google Cloud theo nguyên tắc chỉ cấp quyền truy cập khi cần.

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à tính năng của các API đó.

API Tài liệu tham khảo Các tính năng mẫu
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 tài khoản mẹ đã cho.
  • Liệt kê tất cả tài khoản của người dùng đã được 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ừ 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 xem, tạo, cập nhật hoặc xoá trang doanh nghiệp trên Google.
  • Cho phép người bán tải 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 xem hoặc tìm kiếm chuỗi cửa hàng, danh mục hồ sơ.
API Lưu trú Tài liệu
  • Cho phép quản lý dữ liệu về cơ sở lưu trú, chẳng hạn như các tiện nghi của cơ sở lưu trú và chính sách đối với 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 thuộc tính về cơ sở lưu trú của một Trang doanh nghiệp trên Google.
API Hành động tạ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 đồ ăn giao tận nơi.
Notifications API 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 của một địa điểm.
Business Profile Performance API 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 của trang thông tin doanh nghiệp trên Google.
  • Thông tin chi tiết bao gồm số lượt hiển thị của doanh nghiệp, yêu cầu chỉ đường, lượt nhấp vào nút gọi, lượt nhấp vào trang web, lượt đặt chỗ, lượt đặt món ăn, lượt tương tác với thực đơn và nhiều chỉ số khác.
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 trang doanh nghiệp.
API Bài đánh giá Tài liệu
  • Cho phép người bán nhận bài đánh giá và trả lời bài đánh giá trên trang doanh nghiệp.
Local Posts API Tài liệu
  • Cho phép người bán lấy, tạo hoặc cập nhật bài đăng liên quan đến địa phương.
FoodMenus API Tài liệu
  • Cho phép người bán lấy, tạo hoặc cập nhật thực đơn đồ ăn cho một trang doanh nghiệp.

Nếu bạn vẫn còn thắc mắc về dữ liệu mà mình có thể truy cập và/hoặc cách truy cập vào dữ liệu đó, hãy sử dụng các biểu mẫu sau để gửi yêu cầu:

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 GBP?

Nếu bạn là một đối tác bên thứ ba thực hiện việc quản lý trang thông tin cho doanh nghiệp:

Doanh nghiệp làm cách nào để uỷ quyền cho đối tác API GBP quản lý trang thông tin doanh nghiệp?

Doanh nghiệp có thể cấp quyền truy cập cho đối tác bên thứ ba theo hai cách:

  • Thiết lập OAuth: Hãy 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 xác thực của người bán để thay mặt người bán hoặc doanh nghiệp chỉnh sửa và truy cập vào dữ liệu trên Trang doanh nghiệp trên Google.

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

    Lưu ý: Các đối tác bên thứ ba không nên tự thêm mình làm chủ sở hữu của GBP mà chỉ tự thêm chính họ 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 10 trang doanh nghiệp trở lên. Sau khi xác minh, bạn có thể quản lý các vị trí của chuỗi cửa hàng đã xuất bản 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, ngoại trừ một số trường hợp ngoại lệ. Ví dụ: người quản lý trang web được xử lý khác nhau và họ có thể tự thêm mình vào các địa điểm nhượng quyền.

Giới hạn hạn mức cho các API khác nhau là gì?

Hạn mức thông thường về hạn mức đượ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 bao nhiêu hạn mức?

Hạn mức là một tài nguyên có giới hạn. Nhóm hỗ trợ API GBP sẽ xác định xem yêu cầu tăng hạn mức của bạn có đủ điều kiện 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 thấp hơn 70% hạn mức hiện tại, thì bạn có thể bị từ chối tăng hạn mức.

Đối tác API 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, không có cách trực tiếp nào để tạo trang thông tin GBP giả trong sản phẩm thông qua giao diện người dùng hoặc API GBP và kiểm thử trang thông tin đó.

Hầu hết trang thông tin giả mạo được tạo đều bị nhóm kiểm duyệt của chúng tôi gắn cờ và bị tạm ngưng. Bạn nên sử dụng trang thông tin của khách hàng và làm việc với trang thông tin đó 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 trang thông tin, chẳng hạn như tên, địa chỉ, danh mục) hoặc tạo trang thông tin cho trụ sở công ty của bạn. Nếu muốn kiểm thử phản hồi của API để xác minh một trang thông tin hoặc bất kỳ thao tác nào khác yêu cầu có trang thông tin sản phẩm, thì bạn có thể sử dụng phản hồi API mô phỏng.