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

出力専用。このローカル投稿を accounts/{accountId}/locations/{locationId}/localPosts/{localPostId} の形式で表した Google 識別子です。
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)

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

string

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

enum (LocalPostTopicType)

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

enum (AlertType)

投稿を作成するアラートの種類。このフィールドは、topicType が Alert の投稿にのみ適用され、Alert のサブタイプとして機能します。
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 に関する投稿を管理できます。

LocalPostOffer

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

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

string

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

string

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

string

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

メソッド

create

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

delete

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

get

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

list

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

patch

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

reportInsights

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