REST Resource: accounts.locations.localPosts

แหล่งข้อมูล: LocalPost

แสดงโพสต์ในพื้นที่สำหรับสถานที่ตั้ง

การแสดง 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.
}
ช่อง
name

string

เอาต์พุตเท่านั้น ตัวระบุของ Google สำหรับโพสต์ในพื้นที่นี้ในรูปแบบ accounts/{accountId}/locations/{locationId}/localPosts/{local_post_id}
languageCode

string

ภาษาของโพสต์ท้องถิ่น
summary

string

คำอธิบาย/เนื้อหาของโพสต์ในพื้นที่
callToAction

object (CallToAction)

URL ที่ระบบจะนำผู้ใช้ไปเมื่อคลิกผ่านโปรโมชัน ระบบจะไม่สนใจสำหรับประเภทหัวข้อ OFFER
createTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่สร้างโพสต์

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่ผู้ใช้แก้ไขโพสต์ครั้งล่าสุด

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
scheduledTime

string (Timestamp format)

หากตั้งค่าไว้ จะกำหนดเวลาที่โพสต์จะเผยแพร่ ผู้ใช้สามารถตั้งค่านี้เพื่อกำหนดเวลาโพสต์ล่วงหน้าได้

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
recurringInstanceTime
(deprecated)

string (Timestamp format)

เอาต์พุตเท่านั้น เลิกใช้งานแล้ว: โปรดใช้ event.recurring_instance_time แทน ระบบจะนำช่องนี้ออกในเวอร์ชันในอนาคต เอาต์พุตเท่านั้น เวลาที่อัปเดตอินสแตนซ์ที่เกิดซ้ำล่าสุดของโพสต์

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
event

object (LocalPostEvent)

ข้อมูลเหตุการณ์ ต้องระบุสำหรับประเภทหัวข้อ EVENT และ OFFER
state

enum (LocalPostState)

เอาต์พุตเท่านั้น สถานะของโพสต์ ซึ่งบ่งบอกว่าโพสต์อยู่ในส่วนใดของวงจรการใช้งาน
media[]

object (MediaItem)

สื่อที่เชื่อมโยงกับโพสต์ sourceUrl เป็นฟิลด์ข้อมูลเดียวที่รองรับสำหรับ LocalPost MediaItem
searchUrl

string

เอาต์พุตเท่านั้น ลิงก์ไปยังโพสต์ในพื้นที่ใน Google Search คุณใช้ลิงก์นี้เพื่อแชร์โพสต์ผ่านโซเชียลมีเดีย อีเมล ข้อความ ฯลฯ ได้
topicType

enum (LocalPostTopicType)

ต้องระบุ ประเภทหัวข้อของโพสต์ ได้แก่ มาตรฐาน กิจกรรม ข้อเสนอ หรือการแจ้งเตือน
alertType

enum (AlertType)

ประเภทการแจ้งเตือนที่สร้างโพสต์ ฟิลด์นี้ใช้ได้กับโพสต์ที่มี topicType เป็น Alert เท่านั้น และจะทํางานเป็นประเภทข้อมูลย่อยของการแจ้งเตือน
ฟิลด์ Union topic_type_specific_fields ฟิลด์ที่เฉพาะเจาะจงสำหรับประเภทหัวข้อ topic_type_specific_fields ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
offer

object (LocalPostOffer)

ข้อมูลเพิ่มเติมสำหรับโพสต์ข้อเสนอ คุณควรตั้งค่านี้เมื่อ topicType เป็น OFFER เท่านั้น

CallToAction

การดำเนินการที่จะเกิดขึ้นเมื่อผู้ใช้คลิกผ่านโพสต์

การแสดง JSON 
{
  "actionType": enum (ActionType),
  "url": string
}
ช่อง
actionType

enum (ActionType)

ประเภทของการดำเนินการที่จะดำเนินการ
url

string

URL ที่ระบบจะนำผู้ใช้ไปเมื่อคลิก ควรปล่อยช่องนี้ไว้โดยไม่ต้องตั้งค่าสำหรับ CTA การโทร

ActionType

ประเภทของการดำเนินการที่จะดำเนินการ

Enum
ACTION_TYPE_UNSPECIFIED ไม่ได้ระบุประเภท
BOOK โพสต์นี้ต้องการให้ผู้ใช้จองการนัดหมาย/โต๊ะ/ฯลฯ
ORDER โพสต์นี้ต้องการให้ผู้ใช้สั่งซื้อบางอย่าง
SHOP โพสต์นี้ต้องการให้ผู้ใช้เรียกดูแคตตาล็อกผลิตภัณฑ์
LEARN_MORE โพสต์นี้ต้องการให้ผู้ใช้ดูข้อมูลเพิ่มเติม (ที่เว็บไซต์)
SIGN_UP โพสต์นี้ต้องการให้ผู้ใช้ลงทะเบียน/ลงชื่อสมัครใช้/เข้าร่วม
GET_OFFER

เลิกใช้งานแล้ว ใช้ OFFER ใน LocalPostTopicType เพื่อสร้างโพสต์ที่มีเนื้อหาข้อเสนอ
CALL โพสต์นี้ต้องการให้ผู้ใช้โทรหาธุรกิจ

LocalPostEvent

ข้อมูลทั้งหมดที่เกี่ยวข้องกับกิจกรรมที่แสดงในโพสต์ในพื้นที่

การแสดง JSON 
{
  "title": string,
  "schedule": {
    object (TimeInterval)
  },
  "recurrenceInfo": {
    object (RecurrenceInfo)
  },
  "recurringInstanceTime": string
}
ช่อง
title

string

ชื่อของเหตุการณ์
schedule

object (TimeInterval)

วันที่/เวลาเริ่มต้นและสิ้นสุดของกิจกรรม
recurrenceInfo

object (RecurrenceInfo)

ไม่บังคับ จัดเก็บข้อมูลเกี่ยวกับความถี่ของโพสต์ที่เกิดซ้ำ จะตั้งค่าก็ต่อเมื่อโพสต์เป็นโพสต์ที่เกิดซ้ำ
recurringInstanceTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่อัปเดตอินสแตนซ์ที่เกิดซ้ำล่าสุดของโพสต์

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

TimeInterval

ช่วงเวลา (รวมวันที่เริ่มต้นและวันที่สิ้นสุด) โดยต้องมีช่องทั้งหมดจึงจะถูกต้อง

การแสดง JSON 
{
  "startDate": {
    object (Date)
  },
  "startTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "endTime": {
    object (TimeOfDay)
  }
}
ช่อง
startDate

object (Date)

วันที่เริ่มต้นของระยะเวลานี้
startTime

object (TimeOfDay)

เวลาเริ่มต้นของช่วงเวลานี้
endDate

object (Date)

วันที่สิ้นสุดของระยะเวลานี้
endTime

object (TimeOfDay)

เวลาสิ้นสุดของช่วงเวลานี้

วันที่

แสดงวันที่ในปฏิทินทั้งหมดหรือบางส่วน เช่น วันเกิด เวลาของวันและเขตเวลาจะระบุไว้ที่อื่นหรือไม่มีนัยสำคัญ วันที่สัมพันธ์กับปฏิทินเกรกอเรียน ซึ่งอาจแสดงถึงสิ่งใดสิ่งหนึ่งต่อไปนี้

  • วันที่แบบเต็ม โดยมีค่าปี เดือน และวันที่ที่ไม่ใช่ 0
  • เดือนและวัน โดยมีปีเป็น 0 (เช่น วันครบรอบ)
  • ปีอย่างเดียว โดยมีเดือนและวันที่เป็น 0
  • ปีและเดือน โดยมีวันที่เป็น 0 (เช่น วันหมดอายุของบัตรเครดิต)

ประเภทที่เกี่ยวข้อง

การแสดง JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
ช่อง
year

integer

ปีของวันที่ ต้องอยู่ระหว่าง 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่โดยไม่มีปี
month

integer

เดือนของปี ต้องมีค่าระหว่าง 1 ถึง 12 หรือ 0 เพื่อระบุปีโดยไม่มีเดือนและวัน
day

integer

วันของเดือน ต้องมีค่าตั้งแต่ 1 ถึง 31 และใช้ได้กับปีและเดือน หรือ 0 เพื่อระบุปีอย่างเดียว หรือปีและเดือนที่ไม่มีวัน

TimeOfDay

แสดงเวลาของวัน วันที่และเขตเวลาไม่มีความสำคัญหรือระบุไว้ที่อื่น API อาจเลือกที่จะอนุญาตให้ใช้เวลาอธิกวินาที ประเภทที่เกี่ยวข้องคือ google.type.Date และ google.protobuf.Timestamp

การแสดง JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
ช่อง
hours

integer

ชั่วโมงของวันในรูปแบบ 24 ชั่วโมง ต้องมากกว่าหรือเท่ากับ 0 และโดยปกติแล้วต้องน้อยกว่าหรือเท่ากับ 23 API อาจเลือกอนุญาตค่า "24:00:00" สำหรับสถานการณ์ต่างๆ เช่น เวลาปิดทำการของธุรกิจ
minutes

integer

นาทีในชั่วโมง ต้องมากกว่าหรือเท่ากับ 0 และน้อยกว่าหรือเท่ากับ 59
seconds

integer

วินาทีของนาที ต้องมากกว่าหรือเท่ากับ 0 และโดยทั่วไปต้องน้อยกว่าหรือเท่ากับ 59 API อาจอนุญาตค่า 60 หากอนุญาตให้ใช้ลิปวินาที
nanos

integer

เศษส่วนของวินาทีในหน่วยนาโนวินาที ต้องมากกว่าหรือเท่ากับ 0 และน้อยกว่าหรือเท่ากับ 999,999,999

RecurrenceInfo

แสดงข้อมูลการเกิดซ้ำสำหรับโพสต์ในพื้นที่

การแสดง 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.
}
ฟิลด์
seriesEndTime

string (Timestamp format)

ไม่บังคับ เวลาสิ้นสุดของชุดการเกิดซ้ำ

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
ฟิลด์ Union occurrence_pattern รูปแบบการเกิดของโพสต์ที่เกิดซ้ำ occurrence_pattern ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
dailyPattern

object (DailyOccurrencePattern)

รูปแบบการเกิดรายวัน
weeklyPattern

object (WeeklyOccurrencePattern)

รูปแบบการเกิดซ้ำรายสัปดาห์
monthlyPattern

object (MonthlyOccurrencePattern)

รูปแบบการเกิดรายเดือน

DailyOccurrencePattern

ประเภทนี้ไม่มีฟิลด์

แสดงรูปแบบการเกิดรายวัน

WeeklyOccurrencePattern

แสดงรูปแบบการเกิดรายสัปดาห์

การแสดง JSON 
{
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
ฟิลด์
daysOfWeek[]

enum (DayOfWeek)

ไม่บังคับ รายการวันในสัปดาห์สำหรับข้อเสนอ/กิจกรรม หากเว้นว่างไว้ โพสต์จะทำซ้ำในวันเดียวกันของสัปดาห์ตาม schedule.start_time ของกิจกรรม

วันของสัปดาห์

แสดงวันของสัปดาห์

Enum
DAY_OF_WEEK_UNSPECIFIED ไม่ได้ระบุวันของสัปดาห์
MONDAY วันจันทร์
TUESDAY อังคาร
WEDNESDAY พุธ
THURSDAY พฤหัสบดี
FRIDAY ศุกร์
SATURDAY เสาร์
SUNDAY วันอาทิตย์

MonthlyOccurrencePattern

แสดงรูปแบบการเกิดรายเดือน

การแสดง 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.
}
ช่อง
ฟิลด์ Union monthly_option ตัวเลือกการเกิดซ้ำสำหรับรูปแบบการเกิดซ้ำรายเดือน monthly_option ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
dayOfMonth

integer

วันของเดือน
dayOfWeekOccurrence

enum (DayOfWeekOccurrence)

วันในสัปดาห์ที่เกิดในเดือน วันในสัปดาห์จะอิงตามวันในสัปดาห์ของเวลาเริ่มต้นของกิจกรรม ตัวอย่างเช่น หากกิจกรรมเริ่มในวันศุกร์และ dayOfWeekOccurrence เป็น SECOND กิจกรรมจะเกิดซ้ำในวันศุกร์ที่ 2 ของทุกเดือน

DayOfWeekOccurrence

วันในสัปดาห์ที่เกิดในเดือน

Enum
DAY_OF_WEEK_OCCURRENCE_UNSPECIFIED วันของสัปดาห์ที่ไม่ได้ระบุ
FIRST วันแรกของสัปดาห์ในเดือน
SECOND วันที่ 2 ของสัปดาห์ในเดือน
THIRD วันที่ 3 ของสัปดาห์ในเดือน
FOURTH วันที่ 4 ของสัปดาห์ในเดือน
LAST วันสุดท้ายของสัปดาห์ในเดือน

LocalPostState

ระบุสถานะของโพสต์

Enum
LOCAL_POST_STATE_UNSPECIFIED ไม่ได้ระบุสถานะ
REJECTED โพสต์นี้ถูกปฏิเสธเนื่องจากละเมิดนโยบายเนื้อหา
LIVE โพสต์นี้เผยแพร่แล้วและกำลังปรากฏในผลการค้นหา
PROCESSING ระบบกำลังประมวลผลโพสต์นี้และโพสต์จึงไม่ปรากฏในผลการค้นหา
SCHEDULED โพสต์นี้กำหนดเวลาไว้สำหรับอนาคตและจะไม่ปรากฏในผลการค้นหา
RECURRING โพสต์นี้เป็นโพสต์ที่เกิดซ้ำและกำลังปรากฏในผลการค้นหา

LocalPostTopicType

ประเภทหัวข้อของโพสต์ในพื้นที่ ซึ่งใช้เพื่อเลือกเทมเพลตต่างๆ เพื่อสร้างและแสดงโพสต์

Enum
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทโพสต์
STANDARD โพสต์มีข้อมูลพื้นฐาน เช่น ข้อมูลสรุปและรูปภาพ
EVENT โพสต์มีข้อมูลพื้นฐานและกิจกรรม
OFFER โพสต์มีข้อมูลพื้นฐาน เนื้อหาที่เกี่ยวข้องกับกิจกรรมและข้อเสนอ (เช่น รหัสคูปอง)
ALERT ประกาศที่มีลำดับความสำคัญสูงและทันท่วงทีซึ่งเกี่ยวข้องกับกิจกรรมที่กำลังดำเนินอยู่ โพสต์ประเภทนี้อาจไม่พร้อมให้เขียนเสมอไป

AlertType

ประเภทของเหตุการณ์ที่สร้างโพสต์การแจ้งเตือน

Enum
ALERT_TYPE_UNSPECIFIED ไม่ได้ระบุการแจ้งเตือน
COVID_19 การแจ้งเตือนที่เกี่ยวข้องกับการแพร่ระบาดของโรคติดเชื้อไวรัสโคโรนา 2019 โพสต์เกี่ยวกับโควิดรองรับเฉพาะช่องสรุปและช่องคำกระตุ้นให้ดำเนินการ เมื่อการแจ้งเตือนเหล่านี้ไม่เกี่ยวข้องอีกต่อไป ระบบจะปิดใช้การสร้างโพสต์การแจ้งเตือนใหม่สำหรับประเภทโควิด-19 อย่างไรก็ตาม ผู้ขายจะยังคงจัดการโพสต์เกี่ยวกับโควิด-19 ที่มีอยู่ได้

LocalPostOffer

ฟิลด์ที่เฉพาะเจาะจงสำหรับโพสต์ข้อเสนอ

การแสดง JSON 
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
ฟิลด์
couponCode

string

ไม่บังคับ รหัสข้อเสนอที่ใช้ได้ที่ร้านค้าหรือออนไลน์
redeemOnlineUrl

string

ไม่บังคับ ลิงก์ออนไลน์เพื่อแลกรับข้อเสนอ
termsConditions

string

ไม่บังคับ ข้อกำหนดและเงื่อนไขของข้อเสนอ

เมธอด

create

 สร้างโพสต์ในพื้นที่ใหม่ที่เชื่อมโยงกับสถานที่ที่ระบุ แล้วแสดงผล

delete

 ลบโพสต์ในพื้นที่

get

 รับโพสต์ในพื้นที่ที่ระบุ

list

 แสดงรายการโพสต์ในพื้นที่ที่เชื่อมโยงกับสถานที่ตั้ง

patch

 อัปเดตโพสต์ในพื้นที่ที่ระบุและแสดงผลโพสต์ในพื้นที่ที่อัปเดตแล้ว