REST Resource: accounts.locations.localPosts

Tài nguyên: LocalPost

Đại diện cho một bài đăng tại địa phương cho một vị trí.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "languageCode": string,
  "summary": string,
  "callToAction": {
    object (CallToAction)
  },
  "createTime": string,
  "updateTime": string,
  "scheduledTime": string,
  "recurringInstanceTime": string,
  "event": {
    object (LocalPostEvent)
  },
  "state": enum (LocalPostState),
  "media": [
    {
      object (MediaItem)
    }
  ],
  "searchUrl": string,
  "topicType": enum (LocalPostTopicType),
  "alertType": enum (AlertType),

  // Union field topic_type_specific_fields can be only one of the following:
  "offer": {
    object (LocalPostOffer)
  }
  // End of list of possible types for union field topic_type_specific_fields.
}
Trường
name

string

Chỉ có đầu ra. Giá trị nhận dạng của Google cho bài đăng tại địa phương này ở dạng: accounts/{accountId}/locations/{locationId}/localPosts/{local_post_id}
languageCode

string

Ngôn ngữ của bài đăng tại địa phương.
summary

string

Nội dung mô tả/nội dung của bài đăng tại địa phương.
callToAction

object (CallToAction)

URL mà người dùng được chuyển đến khi nhấp vào chương trình khuyến mãi. Bị bỏ qua đối với loại chủ đề OFFER.
createTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian tạo bài đăng.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Chỉ có đầu ra. Thời gian người dùng sửa đổi bài đăng lần gần đây nhất.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
scheduledTime

string (Timestamp format)

Nếu được đặt, sẽ xác định thời điểm một bài đăng được xuất bản. Người dùng có thể đặt chế độ này để lên lịch đăng bài trước.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
recurringInstanceTime
(deprecated)

string (Timestamp format)

Chỉ có đầu ra. Không dùng nữa: Thay vào đó, hãy sử dụng event.recurring_instance_time. Trường này sẽ bị xoá trong một phiên bản sắp tới. Chỉ có đầu ra. Thời điểm phiên bản định kỳ gần đây nhất của bài đăng được cập nhật.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
event

object (LocalPostEvent)

Thông tin sự kiện. Bắt buộc đối với các loại chủ đề EVENT và OFFER.
state

enum (LocalPostState)

Chỉ có đầu ra. Trạng thái của bài đăng, cho biết bài đăng đang ở giai đoạn nào trong vòng đời.
media[]

object (MediaItem)

Nội dung nghe nhìn được liên kết với bài đăng. sourceUrl là trường dữ liệu duy nhất được hỗ trợ cho LocalPost MediaItem.
searchUrl

string

Chỉ có đầu ra. Đường liên kết đến bài đăng tại địa phương trên Google Tìm kiếm. Bạn có thể dùng đường liên kết này để chia sẻ bài đăng qua mạng xã hội, email, tin nhắn văn bản, v.v.
topicType

enum (LocalPostTopicType)

Bắt buộc. Loại chủ đề của bài đăng: tiêu chuẩn, sự kiện, ưu đãi hoặc cảnh báo.
alertType

enum (AlertType)

Loại cảnh báo mà bài đăng được tạo. Trường này chỉ áp dụng cho các bài đăng có topicType là Alert và hoạt động như một loại phụ của Alerts.
Trường nhóm topic_type_specific_fields. Các trường cụ thể cho một loại chủ đề. topic_type_specific_fields chỉ có thể là một trong những trạng thái sau:
offer

object (LocalPostOffer)

Dữ liệu bổ sung cho bài đăng về ưu đãi. Bạn chỉ nên đặt thông tin này khi topicType là OFFER.

CallToAction

Một hành động được thực hiện khi người dùng nhấp vào bài đăng

Biểu diễn dưới dạng JSON 
{
  "actionType": enum (ActionType),
  "url": string
}
Trường
actionType

enum (ActionType)

Loại hành động sẽ được thực hiện.
url

string

URL mà người dùng sẽ được chuyển hướng đến khi nhấp vào. Bạn không nên đặt trường này cho Lời kêu gọi hành động trong cuộc gọi.

ActionType

Loại hành động sẽ được thực hiện.

Enum
ACTION_TYPE_UNSPECIFIED Chưa chỉ định loại.
BOOK Bài đăng này muốn người dùng đặt lịch hẹn/bàn/v.v.
ORDER Bài đăng này muốn người dùng đặt hàng.
SHOP Bài đăng này muốn người dùng duyệt xem danh mục sản phẩm.
LEARN_MORE Bài đăng này muốn người dùng tìm hiểu thêm (trên trang web của họ).
SIGN_UP Bài đăng này muốn người dùng đăng ký/đăng nhập/tham gia một hoạt động nào đó.
GET_OFFER

Không dùng nữa. Sử dụng OFFER trong LocalPostTopicType để tạo một bài đăng có nội dung ưu đãi.
CALL Bài đăng này muốn người dùng gọi điện cho doanh nghiệp.

LocalPostEvent

Tất cả thông tin liên quan đến một sự kiện xuất hiện trong bài đăng tại địa phương.

Biểu diễn dưới dạng JSON 
{
  "title": string,
  "schedule": {
    object (TimeInterval)
  },
  "recurrenceInfo": {
    object (RecurrenceInfo)
  },
  "recurringInstanceTime": string
}
Trường
title

string

tên của sự kiện.
schedule

object (TimeInterval)

Ngày/giờ bắt đầu và kết thúc sự kiện.
recurrenceInfo

object (RecurrenceInfo)

Không bắt buộc. Lưu trữ thông tin về tần suất của một bài đăng định kỳ. Chỉ được đặt nếu bài đăng là bài đăng định kỳ.
recurringInstanceTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm phiên bản định kỳ gần đây nhất của bài đăng được cập nhật.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

TimeInterval

Một khoảng thời gian, bao gồm cả giá trị đầu và giá trị cuối. Bạn phải điền tất cả các trường để có thể sử dụng.

Biểu diễn dưới dạng JSON 
{
  "startDate": {
    object (Date)
  },
  "startTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "endTime": {
    object (TimeOfDay)
  }
}
Trường
startDate

object (Date)

Ngày bắt đầu của khoảng thời gian này.
startTime

object (TimeOfDay)

Thời gian bắt đầu của khoảng thời gian này.
endDate

object (Date)

Ngày kết thúc của khoảng thời gian này.
endTime

object (TimeOfDay)

Thời gian kết thúc của khoảng thời gian này.

Ngày

Đại diện cho toàn bộ hoặc một phần ngày theo lịch, chẳng hạn như ngày sinh nhật. Thời gian trong ngày và múi giờ được chỉ định ở nơi khác hoặc không quan trọng. Ngày này có liên quan đến Lịch Gregorian. Nội dung này có thể đại diện cho một trong những nội dung sau:

  • Một ngày đầy đủ, với các giá trị năm, tháng và ngày khác 0.
  • Tháng và ngày, giá trị năm bằng 0 (ví dụ: ngày kỷ niệm).
  • Chỉ riêng giá trị năm, với giá trị tháng và ngày bằng 0.
  • Năm và tháng, với giá trị ngày bằng 0 (ví dụ: ngày hết hạn thẻ tín dụng).

Các loại có liên quan:

Biểu diễn dưới dạng JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Trường
year

integer

Năm của ngày. Giá trị phải từ 1 đến 9999 hoặc bằng 0 để chỉ định ngày không có năm.
month

integer

Tháng trong năm. Giá trị phải từ 1 đến 12 hoặc từ 0 để chỉ định một năm không có tháng và ngày.
day

integer

Ngày trong tháng. Giá trị phải từ 1 đến 31 và có giá trị trong năm và tháng, hoặc bằng 0 để chỉ định một năm hoặc một năm và tháng, trong đó ngày là không quan trọng.

TimeOfDay

Biểu thị một thời điểm trong ngày. Ngày và múi giờ không quan trọng hoặc được chỉ định ở nơi khác. Một API có thể chọn cho phép giây nhuận. Các loại liên quan là google.type.Date và google.protobuf.Timestamp.

Biểu diễn dưới dạng JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Trường
hours

integer

Giờ trong ngày ở định dạng 24 giờ. Phải lớn hơn hoặc bằng 0 và thường phải nhỏ hơn hoặc bằng 23. API có thể chọn cho phép giá trị "24:00:00" cho các trường hợp như giờ đóng cửa của doanh nghiệp.
minutes

integer

Số phút trong một giờ. Phải lớn hơn hoặc bằng 0 và nhỏ hơn hoặc bằng 59.
seconds

integer

Số giây trong một phút. Phải lớn hơn hoặc bằng 0 và thường phải nhỏ hơn hoặc bằng 59. Một API có thể cho phép giá trị 60 nếu cho phép giây nhuận.
nanos

integer

Phân số của giây, tính bằng nano giây. Phải lớn hơn hoặc bằng 0 và nhỏ hơn hoặc bằng 999.999.999.

RecurrenceInfo

Biểu thị thông tin định kỳ cho một bài đăng tại địa phương.

Biểu diễn dưới dạng JSON 
{
  "seriesEndTime": string,

  // Union field occurrence_pattern can be only one of the following:
  "dailyPattern": {
    object (DailyOccurrencePattern)
  },
  "weeklyPattern": {
    object (WeeklyOccurrencePattern)
  },
  "monthlyPattern": {
    object (MonthlyOccurrencePattern)
  }
  // End of list of possible types for union field occurrence_pattern.
}
Trường
seriesEndTime

string (Timestamp format)

Không bắt buộc. Thời gian kết thúc của chuỗi sự kiện lặp lại.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
Trường nhóm occurrence_pattern. Mẫu xuất hiện của bài đăng định kỳ. occurrence_pattern chỉ có thể là một trong những trạng thái sau:
dailyPattern

object (DailyOccurrencePattern)

Mẫu lặp lại hằng ngày.
weeklyPattern

object (WeeklyOccurrencePattern)

Mẫu số lần xuất hiện hằng tuần.
monthlyPattern

object (MonthlyOccurrencePattern)

Mẫu định kỳ hằng tháng.

DailyOccurrencePattern

Loại này không có trường nào.

Biểu thị một mẫu lặp lại hằng ngày.

WeeklyOccurrencePattern

Biểu thị một mẫu lặp lại hằng tuần.

Biểu diễn dưới dạng JSON 
{
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
Trường
daysOfWeek[]

enum (DayOfWeek)

Không bắt buộc. Danh sách các ngày trong tuần của sản phẩm/sự kiện. Nếu trống, bài đăng sẽ lặp lại vào cùng ngày trong tuần như schedule.start_time của sự kiện.

DayOfWeek

Biểu thị một ngày trong tuần.

Enum
DAY_OF_WEEK_UNSPECIFIED Ngày trong tuần không được chỉ định.
MONDAY Thứ Hai
TUESDAY Tuesday (thứ Ba)
WEDNESDAY Wednesday (thứ Tư)
THURSDAY Thursday (thứ Năm)
FRIDAY Friday (thứ Sáu)
SATURDAY Saturday (thứ Bảy)
SUNDAY Chủ Nhật

MonthlyOccurrencePattern

Biểu thị một mẫu lặp lại hằng tháng.

Biểu diễn dưới dạng JSON 
{

  // Union field monthly_option can be only one of the following:
  "dayOfMonth": integer,
  "dayOfWeekOccurrence": enum (DayOfWeekOccurrence)
  // End of list of possible types for union field monthly_option.
}
Trường
Trường nhóm monthly_option. Lựa chọn lặp lại cho mẫu lặp lại hằng tháng. monthly_option chỉ có thể là một trong những trạng thái sau:
dayOfMonth

integer

Ngày trong tháng.
dayOfWeekOccurrence

enum (DayOfWeekOccurrence)

Ngày trong tuần diễn ra trong tháng. Ngày trong tuần được ngầm hiểu là ngày trong tuần của thời gian bắt đầu sự kiện. Ví dụ: nếu một sự kiện bắt đầu vào thứ Sáu và dayOfWeekOccurrence là SECOND, thì sự kiện đó sẽ lặp lại vào thứ Sáu thứ hai của mỗi tháng.

DayOfWeekOccurrence

Ngày trong tuần diễn ra trong tháng.

Enum
DAY_OF_WEEK_OCCURRENCE_UNSPECIFIED Ngày trong tuần chưa được chỉ định.
FIRST Ngày đầu tiên trong tuần của tháng.
SECOND Ngày thứ hai trong tuần của tháng.
THIRD Ngày thứ ba trong tuần của tháng.
FOURTH Ngày thứ tư trong tuần của tháng.
LAST Ngày cuối cùng trong tuần của tháng.

LocalPostState

Cho biết trạng thái của bài đăng.

Enum
LOCAL_POST_STATE_UNSPECIFIED Chưa chỉ định tiểu bang.
REJECTED Bài đăng này đã bị từ chối do vi phạm chính sách nội dung.
LIVE Bài đăng này đã được xuất bản và hiện đang xuất hiện trong kết quả tìm kiếm.
PROCESSING Bài đăng này đang được xử lý và không xuất hiện trong kết quả tìm kiếm.
SCHEDULED Bài đăng này được lên lịch cho tương lai và không xuất hiện trong kết quả tìm kiếm.
RECURRING Đây là một bài đăng định kỳ và hiện đang xuất hiện trong kết quả tìm kiếm.

LocalPostTopicType

Loại chủ đề của bài đăng tại địa phương, được dùng để chọn các mẫu khác nhau nhằm tạo và hiển thị bài đăng.

Enum
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED Bạn chưa chỉ định loại bài đăng.
STANDARD Bài đăng chứa thông tin cơ bản, chẳng hạn như nội dung tóm tắt và hình ảnh.
EVENT Bài đăng chứa thông tin cơ bản và một sự kiện.
OFFER Bài đăng có chứa thông tin cơ bản, nội dung liên quan đến sự kiện và ưu đãi (ví dụ: mã giảm giá)
ALERT Thông báo có mức độ ưu tiên cao và kịp thời liên quan đến một sự kiện đang diễn ra. Không phải lúc nào bạn cũng có thể tạo những loại bài đăng này.

AlertType

Loại sự kiện mà bài đăng cảnh báo được tạo ra.

Enum
ALERT_TYPE_UNSPECIFIED Bạn chưa chỉ định thông báo nào.
COVID_19 Cảnh báo liên quan đến đại dịch bệnh do vi-rút corona 2019. Bài đăng về Covid chỉ hỗ trợ trường tóm tắt và trường lời kêu gọi hành động. Khi những cảnh báo này không còn phù hợp, bạn sẽ không thể tạo bài đăng Cảnh báo mới thuộc loại COVID-19. Tuy nhiên, người bán vẫn có thể quản lý các bài đăng hiện có về COVID-19.

LocalPostOffer

Các trường cụ thể cho bài đăng về ưu đãi.

Biểu diễn dưới dạng JSON 
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
Trường
couponCode

string

Không bắt buộc. Mã ưu đãi có thể sử dụng tại cửa hàng hoặc trực tuyến.
redeemOnlineUrl

string

Không bắt buộc. Đường liên kết trực tuyến để sử dụng ưu đãi.
termsConditions

string

Không bắt buộc. Điều khoản và điều kiện của ưu đãi.

Phương thức

create

 Tạo một bài đăng tại địa phương mới được liên kết với vị trí đã chỉ định và trả về bài đăng đó.

delete

 Xoá một bài đăng tại địa phương.

get

 Lấy bài đăng địa phương được chỉ định.

list

 Trả về danh sách các bài đăng tại địa phương liên kết với một vị trí.

patch

 Cập nhật bài đăng tại địa phương được chỉ định và trả về bài đăng tại địa phương đã cập nhật.