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)

สื่อที่เชื่อมโยงกับ post.sourceUrl เป็นช่องข้อมูลเพียงช่องเดียวที่รองรับสําหรับ LocalPost MediaItem
searchUrl

string

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

enum (LocalPostTopicType)

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

enum (AlertType)

ประเภทของการแจ้งเตือนที่โพสต์สร้างขึ้น ช่องนี้ใช้ได้กับโพสต์ของ topicType Alert เท่านั้น โดยทําหน้าที่เป็นประเภทย่อยของการแจ้งเตือน
offer

object (LocalPostOffer)

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

คํากระตุ้นให้ดําเนินการ

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

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

enum (ActionType)

ประเภทการดําเนินการที่จะดําเนินการ
url

string

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

ประเภทการดําเนินการ

ประเภทการดําเนินการที่จะดําเนินการ

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

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

กิจกรรมหลังสุดในพื้นที่

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

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

string

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

object (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)

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

ช่วงเวลาของวัน

แสดงช่วงเวลาของวัน วันที่และเขตเวลาไม่มีนัยสําคัญหรือมีการระบุไว้ที่อื่น 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

สถานะไปรษณีย์ท้องถิ่น

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

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

ประเภทหัวข้อโพสต์ในท้องถิ่น

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

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

ประเภทการแจ้งเตือน

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

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

ข้อเสนอในพื้นที่ภายหลัง

ช่องข้อมูลที่เฉพาะเจาะจงสําหรับโพสต์ข้อเสนอ

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

string

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

string

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

string

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

วิธีการ

create

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

delete

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

get

 ดาวน์โหลดโพสต์ในพื้นที่ที่ระบุ

list

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

patch

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

reportInsights

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