REST Resource: accounts.locations.localPosts

Kaynak: LocalPost

Bir konumla ilgili 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 için şu biçimdeki Google tanımlayıcısı: accounts/{accountId}/locations/{locationId}/localPosts/{localPostId}

languageCode

string

Yerel yayının dilidir.

summary

string

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

callToAction

object (CallToAction)

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

createTime

string (Timestamp format)

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

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, 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 yayının son değiştirilme zamanı.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, 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 zorunludur.

state

enum (LocalPostState)

Yalnızca çıkış. Yayının, yaşam döngüsünün hangi bölümünde olduğunu belirten durumudur.

media[]

object (MediaItem)

post. sourceUrl ile ilişkilendirilen medya, 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, metin vb. aracılığıyla paylaşmak için kullanılabilir.

topicType

enum (LocalPostTopicType)

Zorunlu. Yayının konu türü: standart, etkinlik, fırsat veya uyarı.

alertType

enum (AlertType)

Yayının oluşturulduğu uyarının türü. Bu alan yalnızca topicType Uyarısı yayınları için geçerlidir ve Uyarıların bir alt türü olarak davranır.

offer

object (LocalPostOffer)

Fırsat 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 işlem

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

enum (ActionType)

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

url

string

Tıklandığında kullanıcının yönlendirileceği URL. Bu alan, telefon araması 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 yayın, kullanıcının randevu/masa vs. rezerve etmesini istiyor.
ORDER Bu yayın, bir kullanıcının bir şey sipariş etmesini istiyor.
SHOP Bu yayın, kullanıcının ürün kataloğuna göz atmasını istiyor.
LEARN_MORE Bu yayın, kullanıcının daha fazla bilgi edinmesini istiyor (kendi web sitesinde).
SIGN_UP Bu yayın, kullanıcının bir içeriğe kaydolmasını/kaydolmasını/katılmasını istiyor.
GET_OFFER

Kullanımdan kaldırıldı. Fırsat içeriğine sahip bir yayın oluşturmak için LocalPostTopicType içinde OFFER kullanın.

CALL Bu yayın, bir kullanıcının işletmeyi aramasını istiyor.

LocalPostEvent

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

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

string

Etkinliğin adı.

schedule

object (TimeInterval)

Etkinlik başlangıç ve bitiş tarihi/saati.

TimeInterval

Bir zaman aralığı (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 saatini temsil eder. Tarih ve saat dilimi önemli değil veya başka bir yerde belirtilmiş. API'ler artık saniyelere izin vermeyi tercih edebilir. İlgili türler şunlardır: google.type.Date ve google.protobuf.Timestamp.

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

integer

24 saat biçiminde günün saatleri. 0 ile 23 arasında olmalıdır. API'ler, işletmenin kapanış saati gibi senaryolar için "24:00:00" değerine izin vermeyi tercih edebilir.

minutes

integer

Günün saati dakikaları. 0 ile 59 arasında olmalıdır.

seconds

integer

Dakikanın saniye cinsinden saniyeleri. Normalde 0 ile 59 arasında olmalıdır. Artık saniyelere izin veren API'ler 60 değerine izin verebilir.

nanos

integer

Saniyenin nanosaniye cinsinden kısmı. 0 ile 999.999.999 arasında olmalıdır.

LocalPostState

Yayının bulunduğu durumu belirtir

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

LocalPostTopicType

Yerel yayının konu türü. Yayın oluşturmak ve oluşturmak 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ın, özet ve resimler gibi temel bilgileri içerir.
EVENT Yayın, temel bilgiler ve bir etkinlik içeriyor.
OFFER Yayında temel bilgiler, bir etkinlik ve fırsatla ilgili içerik (ör. kupon kodu) bulunuyor
ALERT Devam eden bir etkinlikle ilgili yüksek öncelikli ve zamanında yapılan duyurular. Bu tür yayınlar her zaman yazılamaz.

AlertType

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

Sıralamalar
ALERT_TYPE_UNSPECIFIED Uyarı belirtilmedi.
COVID_19 2019 Koronavirüs Hastalığı pandemisiyle ilgili uyarılar. COVID yayınları 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ılır. Ancak satıcı 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ılabilecek teklif kodu.

redeemOnlineUrl

string

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

termsConditions

string

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

Yöntemler

create

Belirtilen konumla ilişkilendirilmiş yeni bir yerel yayın oluşturur ve bu yayını döndürür.

delete

Yerel bir yayın silinir.

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 grup yerel yayınla ilgili analizleri döndürür.