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)

投稿に関連付けられているメディア。sourceUrl は、LocalPost MediaItem でサポートされている唯一のデータ フィールドです。
searchUrl

string

出力のみ。Google 検索のローカル投稿へのリンクです。このリンクを使用すると、ソーシャル メディア、メール、テキスト メッセージなどで投稿を共有できます。
topicType

enum (LocalPostTopicType)

必須。投稿のトピックタイプ（標準、イベント、特典、アラート）。
alertType

enum (AlertType)

投稿を作成するアラートの種類。このフィールドは、topicType Alert の投稿にのみ適用され、Alerts のサブタイプとして動作します。
offer

object (LocalPostOffer)

特典に関する投稿の追加データです。topicType が OFFER の場合にのみ設定する必要があります。

CallToAction

ユーザーが投稿をクリックしたときに実行されるアクション。

JSON 表現 
{
  "actionType": enum (ActionType),
  "url": string
}
フィールド
actionType

enum (ActionType)

実行されるアクションのタイプ。
url

string

クリックしたときにユーザーに表示される URL です。電話による問い合わせを促すフレーズでは、このフィールドを未設定のままにする必要があります。

ActionType

実行されるアクションのタイプ。

列挙型
ACTION_TYPE_UNSPECIFIED 未指定
BOOK お店やレストランなどの予約を促します。
ORDER 注文を行うよう促します。
SHOP 商品カタログを閲覧するよう促します。
LEARN_MORE ウェブサイトで詳細を確認するよう促します。
SIGN_UP 登録、申し込み、参加を促します。
GET_OFFER

非推奨です。LocalPostTopicType で OFFER を使用して、特典に関するコンテンツを含む投稿を作成します。
CALL お店やサービスへの電話による問い合わせを促します。

LocalPostEvent

ローカル投稿に掲載されるイベントに関連するすべての情報です。

JSON 表現 
{
  "title": string,
  "schedule": {
    object (TimeInterval)
  }
}
フィールド
title

string

イベントの名前。
schedule

object (TimeInterval)

イベントの開始日時と終了日時です。

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)

この期間の終了時間です。

TimeOfDay

1 日のうちの時刻を表します。日付とタイムゾーンは意味を持たないか、他の場所で指定されています。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 である必要があります。

LocalPostState

投稿の状態を表します。

列挙型
LOCAL_POST_STATE_UNSPECIFIED ステータスが指定されていません。
REJECTED この投稿はコンテンツ ポリシー違反により拒否されました。
LIVE この投稿は公開され、現在検索結果に表示されています。
PROCESSING この投稿は処理中で、検索結果に表示されていません。

LocalPostTopicType

ローカル投稿のトピックタイプです。さまざまなテンプレートを選択して投稿を作成、表示するために使用されます。

列挙型
LOCAL_POST_TOPIC_TYPE_UNSPECIFIED 投稿のタイプが指定されていません。
STANDARD 投稿に概要や画像などの基本情報が含まれています。
EVENT 投稿に基本情報とイベントが含まれています。
OFFER 投稿に、基本情報、イベント、特典に関連するコンテンツ（クーポンコードなど）が含まれています
ALERT 進行中のイベントに関連する、優先度が高く、タイムリーなお知らせ。このタイプの投稿は、作成できない場合があります。

AlertType

アラート投稿が作成されたイベントの種類。

列挙型
ALERT_TYPE_UNSPECIFIED アラートが指定されていません。
COVID_19 2019 年の COVID-19（新型コロナウイルス感染症）のパンデミックに関連するアラート。COVID-19 に関する投稿では、概要フィールドと行動を促すフレーズのフィールドのみがサポートされています。これらのアラートの関連性がなくなると、COVID-19 に関するアラートの投稿を新たに作成できなくなります。ただし、ビジネス オーナーは引き続き既存の COVID-19 に関する投稿を管理できます。

LocalPostOffer

特典に関する投稿専用のフィールドです。

JSON 表現 
{
  "couponCode": string,
  "redeemOnlineUrl": string,
  "termsConditions": string
}
フィールド
couponCode

string

（省略可）店舗またはオンラインで使用可能なクーポンコードです。
redeemOnlineUrl

string

（省略可）特典を利用するためのオンライン リンクです。
termsConditions

string

（省略可）特典の利用規約です。

Methods

create

 指定したビジネスに関連付けられた新しいローカル投稿を作成して返します。

delete

 ローカル投稿を削除します。

get

 指定したローカル投稿を取得します。

list

 ビジネスに関連付けられているローカル投稿のリストを返します。

patch

 指定したローカル投稿を更新し、更新されたローカル投稿を返します。

reportInsights

 単一のリスティングに関連付けられている一連のローカル投稿の分析情報を返します。