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)

イベント情報。トピックタイプが EVENTOFFER の場合は必須です。

state

enum (LocalPostState)

出力専用。投稿のライフサイクルのどの段階にあるかを示す、投稿の状態。

media[]

object (MediaItem)

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

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

非推奨です。LocalPostTopicTypeOFFER を使用して、特典のコンテンツを含む投稿を作成します。

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.Dategoogle.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 の投稿でサポートされているのは、概要フィールドと行動を促すフレーズのフィールドのみです。これらのアラートの関連性がなくなると、COVID-19 タイプの新しいアラート投稿の作成が無効になります。ただし、既存の COVID-19 関連の投稿は引き続き管理できます。

LocalPostOffer

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

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

string

省略可。店舗またはオンラインで使用できるクーポンコード。

redeemOnlineUrl

string

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

termsConditions

string

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

メソッド

create

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

delete

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

get

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

list

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

patch

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

reportInsights

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