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)

वह यूआरएल जिस पर लोगों को प्रमोशन पर क्लिक करने के बाद भेजा जाता है. विषय के टाइप OFFER के लिए अनदेखा किया गया.
createTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. पोस्ट बनाए जाने का समय.

यह आरएफ़सी 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)

सिर्फ़ आउटपुट के लिए. उपयोगकर्ता ने पोस्ट में आखिरी बार कब बदलाव किया था.

यह आरएफ़सी 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)

अगर यह कुकी सेट है, तो इससे यह तय होता है कि पोस्ट कब पब्लिश की जाएगी. उपयोगकर्ता इसे सेट कर सकता है, ताकि पोस्ट को पहले से शेड्यूल किया जा सके.

यह आरएफ़सी 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 का इस्तेमाल करें. इस फ़ील्ड को आने वाले वर्शन में हटा दिया जाएगा. सिर्फ़ आउटपुट के लिए. पोस्ट के सबसे हाल ही के बार-बार होने वाले इंस्टेंस को अपडेट किए जाने का समय.

यह आरएफ़सी 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)

पोस्ट से जुड़ा मीडिया. LocalPost MediaItem के लिए, sourceUrl ही सिर्फ़ इस्तेमाल किया जा सकने वाला डेटा फ़ील्ड है.
searchUrl

string

सिर्फ़ आउटपुट के लिए. Google Search में स्थानीय पोस्ट का लिंक. इस लिंक का इस्तेमाल करके, पोस्ट को सोशल मीडिया, ईमेल, मैसेज वगैरह के ज़रिए शेयर किया जा सकता है.
topicType

enum (LocalPostTopicType)

ज़रूरी है. पोस्ट का विषय: स्टैंडर्ड, इवेंट, ऑफ़र या सूचना.
alertType

enum (AlertType)

पोस्ट किस तरह की सूचना के लिए बनाई गई है. यह फ़ील्ड सिर्फ़ Alert के topicType वाली पोस्ट के लिए लागू होता है. साथ ही, यह Alerts के सब-टाइप के तौर पर काम करता है.
यूनियन फ़ील्ड 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

वह यूआरएल जिस पर उपयोगकर्ता को क्लिक करने के बाद भेजा जाएगा. कॉल वाले सीटीए के लिए, इस फ़ील्ड को सेट नहीं किया जाना चाहिए.

ActionType

कार्रवाई किस तरह की होगी.

Enums
ACTION_TYPE_UNSPECIFIED टाइप की जानकारी नहीं दी गई है.
BOOK इस पोस्ट में, उपयोगकर्ता से अपॉइंटमेंट/टेबल/वगैरह बुक करने के लिए कहा गया है.
ORDER इस पोस्ट में, किसी उपयोगकर्ता से कुछ ऑर्डर करने के लिए कहा गया है.
SHOP इस पोस्ट में, किसी व्यक्ति को प्रॉडक्ट कैटलॉग ब्राउज़ करने के लिए कहा गया है.
LEARN_MORE इस पोस्ट में, उपयोगकर्ता को ज़्यादा जानकारी देने के लिए (उसकी वेबसाइट पर) कहा गया है.
SIGN_UP इस पोस्ट में, किसी उपयोगकर्ता को रजिस्टर/साइन अप/शामिल होने के लिए कहा गया है.
GET_OFFER

समर्थन नहीं होना या रुकना. ऑफ़र के कॉन्टेंट वाली पोस्ट बनाने के लिए, LocalPostTopicType में OFFER का इस्तेमाल करें.
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)

सिर्फ़ आउटपुट के लिए. पोस्ट के सबसे हाल ही के बार-बार होने वाले इंस्टेंस को अपडेट किए जाने का समय.

यह आरएफ़सी 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)

इस अवधि के खत्म होने का समय.

तारीख

यह किसी कैलेंडर की पूरी या कुछ तारीखों को दिखाता है. जैसे, जन्मदिन. दिन के समय और टाइम ज़ोन की जानकारी, कहीं और दी गई है या यह जानकारी ज़रूरी नहीं है. यह तारीख, ग्रेगोरियन कैलेंडर के हिसाब से होती है. यह इनमें से किसी एक को दिखा सकता है:

  • पूरी तारीख, जिसमें साल, महीने, और दिन की वैल्यू शून्य नहीं होनी चाहिए.
  • महीना और दिन, जिसमें साल की वैल्यू शून्य होती है. उदाहरण के लिए, सालगिरह.
  • सिर्फ़ साल, जिसमें महीना और दिन शून्य होता है.
  • साल और महीना, जिसमें दिन की वैल्यू शून्य होती है. उदाहरण के लिए, क्रेडिट कार्ड के खत्म होने की तारीख.

मिलते-जुलते टाइप:

JSON के काेड में दिखाना 
{
  "year": integer,
  "month": integer,
  "day": integer
}
फ़ील्ड
year

integer

तारीख का साल. यह 1 से 9999 के बीच होना चाहिए. साल के बिना तारीख तय करने के लिए, इसे 0 पर सेट करें.
month

integer

साल का महीना. यह वैल्यू 1 से 12 के बीच होनी चाहिए. अगर आपको महीने और दिन के बिना साल की जानकारी देनी है, तो इसे 0 पर सेट करें.
day

integer

महीने का दिन. यह 1 से 31 के बीच होना चाहिए और साल और महीने के लिए मान्य होना चाहिए. इसके अलावा, इसे 0 पर सेट करके सिर्फ़ साल या साल और महीने की जानकारी दी जा सकती है. ऐसे में, दिन की जानकारी देना ज़रूरी नहीं होता.

TimeOfDay

यह दिन के समय को दिखाता है. तारीख और टाइम ज़ोन की जानकारी या तो ज़रूरी नहीं है या कहीं और दी गई है. कोई एपीआई, लीप सेकंड की अनुमति दे सकता है. इससे मिलते-जुलते टाइप google.type.Date और google.protobuf.Timestamp हैं.

JSON के काेड में दिखाना 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
फ़ील्ड
hours

integer

दिन के घंटे, 24 घंटे वाले फ़ॉर्मैट में. यह वैल्यू 0 से ज़्यादा या इसके बराबर होनी चाहिए. आम तौर पर, यह वैल्यू 23 से कम या इसके बराबर होनी चाहिए. एपीआई, कारोबार के बंद होने के समय जैसे मामलों के लिए, "24:00:00" वैल्यू को अनुमति दे सकता है.
minutes

integer

घंटे के मिनट. यह वैल्यू 0 से ज़्यादा या इसके बराबर और 59 से कम या इसके बराबर होनी चाहिए.
seconds

integer

एक मिनट के सेकंड. यह वैल्यू 0 से ज़्यादा या इसके बराबर होनी चाहिए. आम तौर पर, यह वैल्यू 59 से कम या इसके बराबर होनी चाहिए. अगर कोई एपीआई लीप-सेकंड की अनुमति देता है, तो वह वैल्यू 60 की अनुमति दे सकता है.
nanos

integer

सेकंड के हिस्से, नैनोसेकंड में. यह 0 के बराबर या इससे ज़्यादा और 99,99,99,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)

ज़रूरी नहीं. दोहराए जाने वाले इवेंट के खत्म होने का समय.

यह आरएफ़सी 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".
यूनियन फ़ील्ड 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 है.

DayOfWeek

यह हफ़्ते के किसी दिन को दिखाता है.

Enums
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.
}
फ़ील्ड
यूनियन फ़ील्ड monthly_option. हर महीने होने वाले इवेंट के लिए, दोहराए जाने का विकल्प. monthly_option इनमें से सिर्फ़ एक हो सकता है:
dayOfMonth

integer

महीने का दिन.
dayOfWeekOccurrence

enum (DayOfWeekOccurrence)

महीने में हफ़्ते के दिन की संख्या. हफ़्ते का दिन, इवेंट के शुरू होने के समय के हिसाब से तय होता है. उदाहरण के लिए, अगर कोई इवेंट शुक्रवार को शुरू होता है और dayOfWeekOccurrence की वैल्यू SECOND है, तो इवेंट हर महीने के दूसरे शुक्रवार को दोहराया जाएगा.

DayOfWeekOccurrence

महीने में हफ़्ते के दिन की संख्या.

Enums
DAY_OF_WEEK_OCCURRENCE_UNSPECIFIED हफ़्ते के किसी दिन होने वाले इवेंट की जानकारी नहीं दी गई है.
FIRST महीने में हफ़्ते का पहला दिन.
SECOND महीने में हफ़्ते का दूसरा दिन.
THIRD महीने में हफ़्ते का तीसरा दिन.
FOURTH महीने में हफ़्ते का चौथा दिन.
LAST महीने में हफ़्ते का आखिरी दिन.

LocalPostState

इससे पता चलता है कि पोस्ट किस स्थिति में है.

Enums
LOCAL_POST_STATE_UNSPECIFIED राज्य की जानकारी नहीं दी गई है.
REJECTED कॉन्टेंट से जुड़ी नीति के उल्लंघन की वजह से, इस पोस्ट को अस्वीकार कर दिया गया है.
LIVE यह पोस्ट पब्लिश हो चुकी है और फ़िलहाल खोज के नतीजों में दिख रही है.
PROCESSING इस पोस्ट को प्रोसेस किया जा रहा है और यह खोज के नतीजों में नहीं दिख रही है.
SCHEDULED इस पोस्ट को आने वाले समय के लिए शेड्यूल किया गया है. इसलिए, यह खोज के नतीजों में नहीं दिख रही है.
RECURRING यह पोस्ट बार-बार दिखने वाली पोस्ट है और फ़िलहाल खोज के नतीजों में दिख रही है.

LocalPostTopicType

लोकल पोस्ट का विषय, जिसका इस्तेमाल पोस्ट बनाने और रेंडर करने के लिए अलग-अलग टेंप्लेट चुनने के लिए किया जाता है.

Enums
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED पोस्ट का कोई टाइप नहीं बताया गया है.
STANDARD पोस्ट में बुनियादी जानकारी शामिल है, जैसे कि खास जानकारी और इमेज.
EVENT पोस्ट में बुनियादी जानकारी और एक इवेंट शामिल है.
OFFER पोस्ट में बुनियादी जानकारी, इवेंट और ऑफ़र से जुड़ा कॉन्टेंट (जैसे, कूपन कोड) शामिल हो
ALERT मौजूदा इवेंट से जुड़ी, ज़्यादा प्राथमिकता वाली और समय पर की जाने वाली सूचनाएं. इस तरह की पोस्ट हमेशा नहीं बनाई जा सकतीं.

AlertType

वह इवेंट टाइप जिसके लिए सूचना वाली पोस्ट बनाई गई थी.

Enums
ALERT_TYPE_UNSPECIFIED कोई सूचना सेट नहीं की गई है.
COVID_19 साल 2019 में कोरोना वायरस से होने वाली बीमारी की महामारी से जुड़ी सूचनाएं. कोविड पोस्ट में सिर्फ़ खास जानकारी और कॉल-टू-ऐक्शन फ़ील्ड का इस्तेमाल किया जा सकता है. जब ये चेतावनियां काम की नहीं रहेंगी, तब COVID-19 के लिए नई चेतावनी वाली पोस्ट बनाने की सुविधा बंद कर दी जाएगी. हालांकि, कारोबारी या कंपनी अब भी COVID-19 से जुड़ी अपनी मौजूदा पोस्ट मैनेज कर पाएगी.

LocalPostOffer

ऑफ़र पोस्ट के लिए खास फ़ील्ड.

JSON के काेड में दिखाना 
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
फ़ील्ड
couponCode

string

ज़रूरी नहीं. ऑफ़र कोड, जिसका इस्तेमाल स्टोर में या ऑनलाइन किया जा सकता है.
redeemOnlineUrl

string

ज़रूरी नहीं. ऑफ़र रिडीम करने के लिए ऑनलाइन लिंक.
termsConditions

string

ज़रूरी नहीं. ऑफ़र के नियम और शर्तें.

तरीके

create

 यह तय की गई जगह से जुड़ी एक नई स्थानीय पोस्ट बनाता है और उसे दिखाता है.

delete

 इस तरीके का इस्तेमाल करके, स्थानीय पोस्ट को मिटाया जा सकता है.

get

 इस तरीके से, किसी स्थानीय पोस्ट को ऐक्सेस किया जा सकता है.

list

 इससे किसी जगह से जुड़ी स्थानीय पोस्ट की सूची मिलती है.

patch

 यह फ़ंक्शन, तय की गई लोकल पोस्ट को अपडेट करता है और अपडेट की गई लोकल पोस्ट दिखाता है.