REST Resource: accounts.locations.localPosts

Kaynak: LocalPost

Bir konum için yerel gönderiyi temsil eder.

JSON gösterimi 
{
  "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.
}
Alanlar
name

string

Yalnızca çıkış. Bu yerel yayının Google tanımlayıcısı şu biçimdedir: accounts/{accountId}/locations/{locationId}/localPosts/{local_post_id}
languageCode

string

Yerel yayının dili.
summary

string

Yerel yayının açıklaması/gövdesi.
callToAction

object (CallToAction)

Kullanıcıların promosyonu tıkladığında yönlendirildiği URL. OFFER konu türü için yoksayılır.
createTime

string (Timestamp format)

Yalnızca çıkış. Yayının oluşturulma zamanı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Yalnızca çıkış. Kullanıcı tarafından yapılan yayının son değiştirilme zamanı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
scheduledTime

string (Timestamp format)

Ayarlanırsa yayının ne zaman yayınlanacağını belirler. Bu ayar, kullanıcı tarafından gönderileri önceden planlamak için belirlenebilir.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
recurringInstanceTime
(deprecated)

string (Timestamp format)

Yalnızca çıkış. Desteği sonlandırıldı: Bunun yerine event.recurring_instance_time kullanın. Bu alan, gelecekteki bir sürümde kaldırılacaktır. Yalnızca çıkış. Gönderinin en son yinelenen örneğinin güncellendiği zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
event

object (LocalPostEvent)

Etkinlik bilgileri. EVENT ve OFFER konu türleri için gereklidir.
state

enum (LocalPostState)

Yalnızca çıkış. Gönderinin yaşam döngüsünün hangi aşamasında olduğunu gösteren durum.
media[]

object (MediaItem)

Yayınla ilişkili medya. sourceUrl, LocalPost MediaItem için desteklenen tek veri alanıdır.
searchUrl

string

Yalnızca çıkış. Google Arama'daki yerel yayının bağlantısı. Bu bağlantı, yayını sosyal medya, e-posta, kısa mesaj vb. aracılığıyla paylaşmak için kullanılabilir.
topicType

enum (LocalPostTopicType)

Zorunlu. Yayının konu türü: standart, etkinlik, teklif veya uyarı.
alertType

enum (AlertType)

Yayının oluşturulduğu uyarı türü. Bu alan yalnızca topicType Alert türündeki yayınlar için geçerlidir ve uyarıların bir alt türü olarak işlev görür.
topic_type_specific_fields birleşik alanı. Bir konu türü için belirli alanlar. topic_type_specific_fields aşağıdakilerden yalnızca biri olabilir:
offer

object (LocalPostOffer)

Teklif yayınları için ek veriler. Bu özellik yalnızca topicType OFFER olduğunda ayarlanmalıdır.

CallToAction

Kullanıcı yayını tıkladığında gerçekleştirilen bir işlem

JSON gösterimi 
{
  "actionType": enum (ActionType),
  "url": string
}
Alanlar
actionType

enum (ActionType)

Gerçekleştirilecek işlemin türü.
url

string

Kullanıcının tıkladığında yönlendirileceği URL. Bu alan, görüşme CTA'sı için ayarlanmadan bırakılmalıdır.

ActionType

Gerçekleştirilecek işlemin türü.

Sıralamalar
ACTION_TYPE_UNSPECIFIED Tür belirtilmedi.
BOOK Bu gönderi, kullanıcının randevu/masa vb. ayırtmasını istiyor.
ORDER Bu gönderide, kullanıcılardan bir şey sipariş etmeleri isteniyor.
SHOP Bu gönderi, kullanıcının bir ürün kataloğuna göz atmasını istiyor.
LEARN_MORE Bu gönderi, kullanıcının daha fazla bilgi edinmesini (web sitesinde) istiyor.
SIGN_UP Bu gönderide, kullanıcının bir yere kaydolması/üye olması/katılması isteniyor.
GET_OFFER

Kullanımdan kaldırıldı. LocalPostTopicType içinde OFFER simgesini kullanarak teklif içeriği içeren bir gönderi oluşturun.
CALL Bu gönderide, kullanıcının işletmeyi araması isteniyor.

LocalPostEvent

Yerel bir yayında yer alan bir etkinlikle ilgili tüm bilgiler.

JSON gösterimi 
{
  "title": string,
  "schedule": {
    object (TimeInterval)
  },
  "recurrenceInfo": {
    object (RecurrenceInfo)
  },
  "recurringInstanceTime": string
}
Alanlar
title

string

Etkinliğin adı.
schedule

object (TimeInterval)

Etkinliğin başlangıç ve bitiş tarihi/saati.
recurrenceInfo

object (RecurrenceInfo)

İsteğe bağlı. Tekrarlanan bir yayının sıklığıyla ilgili bilgileri depolar. Yalnızca gönderi yinelenen bir gönderiyse ayarlanır.
recurringInstanceTime

string (Timestamp format)

Yalnızca çıkış. Gönderinin en son yinelenen örneğinin güncellendiği zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

TimeInterval

Zaman aralığı (girilen tarihler dahil). Geçerli olması için tüm alanları içermelidir.

JSON gösterimi 
{
  "startDate": {
    object (Date)
  },
  "startTime": {
    object (TimeOfDay)
  },
  "endDate": {
    object (Date)
  },
  "endTime": {
    object (TimeOfDay)
  }
}
Alanlar
startDate

object (Date)

Bu dönemin başlangıç tarihi.
startTime

object (TimeOfDay)

Bu dönemin başlangıç zamanı.
endDate

object (Date)

Bu dönemin bitiş tarihi.
endTime

object (TimeOfDay)

Bu dönemin bitiş zamanı.

Tarih

Doğum günü gibi tam veya kısmi bir takvim tarihini gösterir. Günün saati ve saat dilimi başka bir yerde belirtilmiştir veya önemsizdir. Tarih, Gregoryen Takvimi'ne göre belirlenir. Bu, aşağıdakilerden birini temsil edebilir:

  • Yıl, ay ve gün değerleri sıfır olmayan tam bir tarih.
  • Yılın sıfır olduğu bir ay ve gün (örneğin, yıl dönümü).
  • Tek başına bir yıl, sıfır ay ve sıfır gün.
  • Bir yıl ve ay, sıfır günle (örneğin, kredi kartı son kullanma tarihi).

İlgili türler:

JSON gösterimi 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. 1 ile 9999 arasında olmalı veya yıl içermeyen bir tarih belirtmek için 0 olmalıdır.
month

integer

Yılın ayı. 1 ile 12 arasında olmalı veya ay ve gün içermeyen bir yıl belirtmek için 0 olmalıdır.
day

integer

Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerli olmalıdır. Yalnızca bir yılı veya günün önemli olmadığı bir yıl ve ayı belirtmek için 0 değeri kullanılabilir.

TimeOfDay

Günün bir saatini temsil eder. Tarih ve saat dilimi önemli değildir veya başka bir yerde belirtilmiştir. Bir API, artık saniyelere izin vermeyi seçebilir. İlgili türler google.type.Date ve google.protobuf.Timestamp'dır.

JSON gösterimi 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Alanlar
hours

integer

24 saatlik biçimde günün saatleri. 0'dan büyük veya 0'a eşit olmalı ve genellikle 23'ten küçük veya 23'e eşit olmalıdır. Bir API, işletmenin kapanış saati gibi senaryolarda "24:00:00" değerine izin vermeyi seçebilir.
minutes

integer

Saatin dakikaları. 0'dan büyük veya 0'a eşit ve 59'dan küçük veya 59'a eşit olmalıdır.
seconds

integer

Bir dakikanın saniyeleri. 0'dan büyük veya 0'a eşit olmalı ve genellikle 59'dan küçük veya 59'a eşit olmalıdır. Bir API, artık saniyelere izin veriyorsa 60 değerine izin verebilir.
nanos

integer

Saniyenin nanosaniye cinsinden kesirleri. 0'dan büyük veya 0'a eşit ve 999.999.999'dan küçük veya 999.999.999'a eşit olmalıdır.

RecurrenceInfo

Yerel gönderinin tekrar bilgileri.

JSON gösterimi 
{
  "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.
}
Alanlar
seriesEndTime

string (Timestamp format)

İsteğe bağlı. Yinelenen serinin bitiş zamanı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
occurrence_pattern birleşik alanı. Düzenli yayının gerçekleşme düzeni. occurrence_pattern aşağıdakilerden yalnızca biri olabilir:
dailyPattern

object (DailyOccurrencePattern)

Günlük oluşum kalıbı.
weeklyPattern

object (WeeklyOccurrencePattern)

Haftalık gerçekleşme kalıbı.
monthlyPattern

object (MonthlyOccurrencePattern)

Aylık oluşum kalıbı.

DailyOccurrencePattern

Bu türde alan yok.

Günlük oluşum düzenini gösterir.

WeeklyOccurrencePattern

Haftalık bir oluşum modelini temsil eder.

JSON gösterimi 
{
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
Alanlar
daysOfWeek[]

enum (DayOfWeek)

İsteğe bağlı. Teklif/etkinlik için haftanın günlerinin listesi. Boşsa yayın, etkinliğin schedule.start_time ile aynı haftanın günü tekrarlanır.

HaftanınGünü

Haftanın bir gününü temsil eder.

Sıralamalar
DAY_OF_WEEK_UNSPECIFIED Haftanın günü belirtilmemiş.
MONDAY Pazartesi
TUESDAY Salı
WEDNESDAY Çarşamba
THURSDAY Perşembe
FRIDAY Cuma
SATURDAY Cumartesi
SUNDAY Pazar

MonthlyOccurrencePattern

Aylık yinelenme kalıbını gösterir.

JSON gösterimi 
{

  // 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.
}
Alanlar
monthly_option birleşik alanı. Aylık tekrar eden etkinlikler için tekrar seçeneği. monthly_option aşağıdakilerden yalnızca biri olabilir:
dayOfMonth

integer

Ayın günü.
dayOfWeekOccurrence

enum (DayOfWeekOccurrence)

Ay içinde haftanın gününün kaçıncı kez gerçekleştiği. Haftanın günü, etkinliğin başlangıç saatinin haftanın günüyle belirtilir. Örneğin, bir etkinlik Cuma günü başlıyorsa ve dayOfWeekOccurrence değeri SECOND ise etkinlik her ayın ikinci Cuma günü tekrarlanır.

DayOfWeekOccurrence

Ay içinde haftanın gününün kaçıncı kez gerçekleştiği.

Sıralamalar
DAY_OF_WEEK_OCCURRENCE_UNSPECIFIED Haftanın hangi gününde gerçekleştiği belirtilmemiş.
FIRST Ayın ilk haftasının ilk günü.
SECOND Ayın ikinci haftası.
THIRD Ayın haftasındaki üçüncü gün.
FOURTH Ayın haftasındaki dördüncü gün.
LAST Ayın son haftasının son günü.

LocalPostState

Yayının hangi durumda olduğunu gösterir.

Sıralamalar
LOCAL_POST_STATE_UNSPECIFIED Eyalet belirtilmedi.
REJECTED Bu yayın, içerik politikası ihlali nedeniyle reddedildi.
LIVE Bu yayın yayınlanmış ve şu anda arama sonuçlarında gösteriliyor.
PROCESSING Bu yayın işleniyor ve arama sonuçlarında görünmüyor.
SCHEDULED Bu yayın gelecekte yayınlanacak şekilde planlandığı için arama sonuçlarında görünmüyor.
RECURRING Bu yayın, yinelenen bir yayındır ve şu anda arama sonuçlarında gösterilmektedir.

LocalPostTopicType

Yayın oluşturmak ve yayınlamak için farklı şablonlar seçmek üzere kullanılan yerel yayının konu türü.

Sıralamalar
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED Yayın türü belirtilmedi.
STANDARD Yayın, özet ve resim gibi temel bilgiler içeriyor.
EVENT Gönderi, temel bilgileri ve bir etkinliği içerir.
OFFER Yayın temel bilgiler, bir etkinlik ve teklifle ilgili içerik (ör. kupon kodu) içeriyor
ALERT Devam eden bir etkinlikle ilgili yüksek öncelikli ve zamanında yapılan duyurular. Bu tür yayınlar her zaman oluşturulamaz.

AlertType

Uyarı yayınının oluşturulduğu etkinlik türü.

Sıralamalar
ALERT_TYPE_UNSPECIFIED Uyarı belirtilmedi.
COVID_19 2019 Koronavirüs Hastalığı pandemisiyle ilgili uyarılar. Covid gönderileri yalnızca özet alanını ve harekete geçirici mesaj alanını destekler. Bu uyarılar artık alakalı olmadığında COVID-19 türü için yeni uyarı yayını oluşturma özelliği devre dışı bırakılacak. Ancak satıcılar, mevcut COVID-19 ile ilgili gönderilerini yönetmeye devam edebilir.

LocalPostOffer

Fırsat yayınlarına özel alanlar.

JSON gösterimi 
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
Alanlar
couponCode

string

İsteğe bağlı. Mağazada veya online olarak kullanılabilen fırsat kodu.
redeemOnlineUrl

string

İsteğe bağlı. Tekliften yararlanmak için kullanılan online bağlantı.
termsConditions

string

İsteğe bağlı. Teklif hükümleri ve koşulları.

Yöntemler

create

 Belirtilen konumla ilişkili yeni bir yerel gönderi oluşturur ve döndürür.

delete

 Yerel yayını siler.

get

 Belirtilen yerel gönderiyi alır.

list

 Bir konumla ilişkili yerel gönderilerin listesini döndürür.

patch

 Belirtilen yerel yayını günceller ve güncellenen yerel yayını döndürür.