REST Resource: accounts.locations.localPosts

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

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

การแสดง JSON 
{
  "name": string,
  "languageCode": string,
  "summary": string,
  "callToAction": {
    object (CallToAction)
  },
  "createTime": string,
  "updateTime": string,
  "event": {
    object (LocalPostEvent)
  },
  "state": enum (LocalPostState),
  "media": [
    {
      object (MediaItem)
    }
  ],
  "searchUrl": string,
  "topicType": enum (LocalPostTopicType),
  "alertType": enum (AlertType),
  "offer": {
    object (LocalPostOffer)
  }
}
ช่อง
name

string

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

string

ภาษาของโพสต์ในพื้นที่
summary

string

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

object (CallToAction)

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

string (Timestamp format)

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

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
updateTime

string (Timestamp format)

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

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
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 และทำหน้าที่เป็นการแจ้งเตือนประเภทย่อย
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)
  }
}
ช่อง
title

string

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

object (TimeInterval)

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

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)

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

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

LocalPostState

ระบุว่าโพสต์อยู่ในสถานะใด

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

LocalPostTopicType

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

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

AlertType

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

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

LocalPostOffer

ช่องเฉพาะสำหรับโพสต์ข้อเสนอ

การแสดง JSON 
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
ช่อง
couponCode

string

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

string

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

string

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

เมธอด

create

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

delete

 ลบโพสต์ในเครื่อง

get

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

list

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

patch

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

reportInsights

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