API Google Doanh nghiệp của tôi cho phép bạn tạo Bài đăng trên 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 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 về lời 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 xác thực OAuth 2.0.
Để biết thông tin 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 Thiết lập cơ bản.
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 Bài đăng. Bài đăng của bạn cho một 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 lên tài khoản liên kết với người dùng, hãy sử dụng API accounts.locations.localPosts
.
Để tạo Bài đăng cho người dùng đã xác thực, hãy sử dụng các lệnh 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
Bài đăng có lời kêu gọi hành động bao gồm một nút. Văn bản trên nút kêu gọi hành động được xác định bằng trường actionType
của Bài đăng. Đường liên kết đến URL do người dùng cung cấp sẽ được thêm vào nút.
Để tạo Bài đăng có nút kêu gọi hành động, hãy sử dụng các công cụ 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 thao tác
Lời kêu gọi hành động Bài đăng có thể có các loại hành động khác nhau giúp xác định loại lời kêu gọi hành động của Bài đăng.
Sau đây là các loại lời kêu gọi hành động được hỗ trợ:
Loại thao tác | |
---|---|
BOOK |
Tạo một bài đăng nhắc người dùng đặt lịch hẹn, đặt bàn hoặc dịch vụ tương tự. |
ORDER |
Tạo bài đăng nhắc người dùng đặt hàng. |
SHOP |
Tạo một Bài đăng nhắc người dùng duyệt xem danh mục sản phẩm. |
LEARN_MORE |
Tạo Bài đăng nhắc người dùng xem thêm thông tin chi tiết trên một trang web. |
SIGN_UP |
Tạo Bài đăng nhắc người dùng đăng ký, đăng ký hoặc tham gia nội dung nào đó. |
CALL |
Tạo 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 Bài đăng về ưu đãi, hãy sử dụng:
$ 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 cách gửi yêu cầu PATCH
.
Để chỉnh sửa Bài đăng, hãy sử dụng các thao tác 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 Bài đăng, bạn có thể xoá bài đăng đó bằng cách yêu cầu DELETE
.
Để xoá Bài đăng, hãy dùng các thao tác sau:
$ DELETE https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}