API Google Doanh nghiệp của tôi cho phép bạn tạo Bài đăng trong Google Tìm kiếm trong một số danh mục, chẳng hạn như tin tức, sự kiện và ưu đãi.
Hướng dẫn này sẽ chỉ cho bạn cách thực hiện những việc sau:
- Tạo bài đăng về sự kiện.
- Tạo bài đăng kêu gọi hành động.
- Tạo bài đăng về ưu đãi.
- Chỉnh sửa bài đăng.
- Xoá bài đăng.
Trước khi bắt đầu
Trước khi sử dụng API Google Doanh nghiệp của tôi, bạn cần đăng ký ứng dụng và lấy thông tin đăng nhập OAuth 2.0.
Để biết chi tiết về cách bắt đầu sử dụng API Google Doanh nghiệp của tôi, hãy xem bài viết Cơ bản thiết lập.
Bài đăng về sự kiện
Thông báo cho khách hàng về sự kiện tiếp theo tại doanh nghiệp của bạn bằng một Bài đăng. Thông tin Bài đăng sự kiện bao gồm ngày và giờ bắt đầu và kết thúc, hiển thị nổi bật trên Bài đăng.
Để tạo Bài đăng với một tài khoản được liên kết với người dùng, hãy sử dụng
accounts.locations.localPosts
.
Để tạo một Bài đăng cho người dùng đã xác thực, hãy sử dụng các hàm sau:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Come in for our spooky Halloween event!", "event": { "title": "Halloween Spook-tacular!", "schedule": { "startDate": { "year": 2017, "month": 10, "day": 31, }, "startTime": { "hours": 9, "minutes": 0, "seconds": 0, "nanos": 0, }, "endDate": { "year": 2017, "month": 10, "day": 31, }, "endTime": { "hours": 17, "minutes": 0, "seconds": 0, "nanos": 0, }, } }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-image.jpg", } ], "topicType": "EVENT" }
Bài đăng kêu gọi hành động
Các bài đăng có lời kêu gọi hành động sẽ có một nút. Văn bản trong lời kêu gọi hành động
nút do trường actionType
của Bài đăng xác định. Một đường liên kết đến
URL do người dùng cung cấp sẽ được thêm vào nút này.
Để tạo một Bài đăng có nút kêu gọi hành động, hãy làm như sau:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Order your Thanksgiving turkeys now!!", "callToAction": { "actionType": "ORDER", "url": "http://google.com/order_turkeys_here", }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-turkey-photo.jpg", } ], "topicType": "OFFER" }
Loại hành động
Bài đăng kêu gọi hành động có thể có các loại hành động khác nhau để xác định loại về lời kêu gọi hành động trên Bài đăng.
Sau đây là các loại lời kêu gọi hành động được hỗ trợ:
Loại hành động | |
---|---|
BOOK |
Tạo một Bài đăng nhắc người dùng đặt cuộc hẹn, đặt bàn hoặc nội dung tương tự. |
ORDER |
Tạo một Bài đăng nhắc người dùng đặt món. |
SHOP |
Tạo một bài đăng nhắc người dùng duyệt xem một sản phẩm danh mục nhạc phẩm. |
LEARN_MORE |
Tạo một bài đăng nhắc người dùng xem thêm chi tiết về của bạn. |
SIGN_UP |
Tạo một bài đăng nhắc người dùng đăng ký, đăng ký tài khoản hoặc tham gia một điều gì đó. |
CALL |
Tạo một Bài đăng nhắc người dùng gọi điện cho một doanh nghiệp. |
Bài đăng về ưu đãi
Để tạo một Bài đăng về ưu đãi, hãy sử dụng các thành phần sau:
$ POST https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts { "languageCode": "en-US", "summary": "Buy one Google jetpack, get a second one free!!", "offer": { "couponCode": “BOGO-JET-CODE”, "redeemOnlineUrl": “https://www.google.com/redeem”, "termsConditions": “Offer only valid if you can prove you are a time traveler” }, "media": [ { "mediaFormat": "PHOTO", "sourceUrl": "https://www.google.com/real-jetpack-photo.jpg", } ], "topicType": "OFFER" }
Chỉnh sửa bài đăng
Sau khi tạo bài đăng, bạn có thể chỉnh sửa bài đăng đó bằng yêu cầu PATCH
.
Để chỉnh sửa Bài đăng, hãy dùng các chức năng sau:
$ PATCH https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}?updateMask=summary { "summary": "Order your Christmas turkeys now!!" }
Xoá bài đăng
Sau khi tạo một Bài đăng, bạn có thể xoá bài đăng đó bằng yêu cầu DELETE
.
Để xoá một Bài đăng, hãy dùng cách sau:
$ DELETE https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}