REST Resource: accounts.locations.localPosts

Kaynak: LocalPost

Bir konum için yerel yayını temsil eder.

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

string

Yalnızca çıkış. Bu yerel yayının Google tanımlayıcısının şu biçimde olması gerekir: accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}

languageCode

string

Yerel gönderinin dili.

summary

string

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

callToAction

object (CallToAction)

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

createTime

string (Timestamp format)

Yalnızca çıkış. Yayının oluşturulduğu zaman.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

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

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

event

object (LocalPostEvent)

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

state

enum (LocalPostState)

Yalnızca çıkış. Yaşam döngüsünün hangi aşamasında olduğunu belirten yayın durumu.

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. üzerinden 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 için oluşturulan uyarı türü. Bu alan yalnızca topicType Alert olan yayınlar için geçerlidir ve Uyarılar'ın alt türü gibi davranır.

offer

object (LocalPostOffer)

Teklif yayınları için ek veriler. Bu 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şlem türü.

url

string

Kullanıcının tıkladığında yönlendirileceği URL. Bu alan, telefonla CTA 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ıdan randevu/masa/vb. rezervasyonu yapmasını istiyor.
ORDER Bu gönderide kullanıcıdan bir şey sipariş etmesi isteniyor.
SHOP Bu gönderi, kullanıcının bir ürün kataloğuna göz atmasını istiyor.
LEARN_MORE Bu yayında, kullanıcının daha fazla bilgi edinmesi (web sitesinde) isteniyor.
SIGN_UP Bu gönderi, kullanıcının bir yere kaydolmasını/üye olmasını/katılmasını istiyor.
GET_OFFER

Kullanımdan kaldırıldı. Teklif içeriği içeren bir yayın oluşturmak için LocalPostTopicType içinde OFFER kullanın.

CALL Bu gönderide kullanıcıdan 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)
  }
}
Alanlar
title

string

Etkinliğin adı.

schedule

object (TimeInterval)

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

TimeInterval

Bir zaman aralığı (belirtilenler 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ı.

TimeOfDay

Günün bir saatini temsil eder. Tarih ve saat dilimi önemli değil veya başka bir yerde belirtilmiş. Bir API, saniye atlamalarına izin vermeyi seçebilir. İlgili türler google.type.Date ve google.protobuf.Timestamp'dur.

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

integer

Günün saati, 24 saat biçiminde. 0 ile 23 arasında olmalıdır. Bir API, işletmenin kapanma zamanı gibi senaryolar için "24:00:00" değerine izin vermeyi seçebilir.

minutes

integer

Günün saati (dakika cinsinden). 0 ile 59 arasında olmalıdır.

seconds

integer

Zamandaki dakikaların saniyeleri. Normalde 0 ile 59 arasında olmalıdır. Bir API, saniye atlamalarına izin veriyorsa 60 değerine izin verebilir.

nanos

integer

Milisaniye cinsinden saniye kesirlerini belirtir. 0 ile 999.999.999 arasında olmalıdır.

LocalPostState

Gönderinin durumunu gösterir

Sıralamalar
LOCAL_POST_STATE_UNSPECIFIED Eyalet belirtilmemiş.
REJECTED Bu gönderi, içerik politikası ihlali nedeniyle reddedildi.
LIVE Bu yayın yayınlandı ve şu anda arama sonuçlarında gösteriliyor.
PROCESSING Bu yayın işleniyor ve arama sonuçlarında görünmüyor.

LocalPostTopicType

Yerel yayının konu türü. Bu tür, yayın oluşturmak ve yayınlamak için farklı şablonlar seçmek amacıyla kullanılır.

Sıralamalar
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED Yayın türü belirtilmedi.
STANDARD Yayında özet ve resimler gibi temel bilgiler yer alıyor.
EVENT Yayın, temel bilgileri ve bir etkinliği içerir.
OFFER Yayın temel bilgiler, etkinlik ve teklifle ilgili içerik (ör. kupon kodu) içeriyor
ALERT Devam eden bir etkinlikle ilgili yüksek öncelikli ve zamanında duyurular. Bu tür yayınlar her zaman yazarlık için kullanılamaz.

AlertType

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

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

LocalPostOffer

Fırsat yayınları için özel alanlar.

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

string

İsteğe bağlı. Mağazada veya internette kullanılabilen teklif kodu.

redeemOnlineUrl

string

İsteğe bağlı. Tekliften yararlanma için 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 yayın oluşturur ve döndürür.

delete

Yerel bir yayını siler.

get

Belirtilen yerel yayını alır.

list

Bir konumla ilişkili yerel yayınların listesini döndürür.

patch

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

reportInsights

Tek bir girişle ilişkili bir dizi yerel yayınla ilgili analizleri döndürür.