1
回答済み
API
お知らせ(投稿)APIの scheduledAt はどのタイムゾーンですか?
グレープ
·
2026/11/10 09:10
社内で、お知らせの投稿を外部のツールから予約するために、POST /api/v1/organizations/{organizationId}/posts を確認しています。
scheduledAt はUTCで送ればよいですか? また、公開されたときにお客様へ通知は届きますか?
回覆 (1)
scheduledAt は、UTCではなく日本時間で、タイムゾーンを付けずに指定します(例: 2026-11-20T18:00:00)。UTCに変換した値や、Z、+09:00 などのオフセットを付けた値は送らないでください。
未来の時刻を指定して作成すると、状態が Scheduled になります。予約した投稿は5分ごとに確認して公開するので、公開は指定の時刻から最大5分ほど遅れます。
- 指定しないで作成すると
Draftです。すぐに公開するときはPOST .../posts/{postId}/publishを呼びます。 - 状態は
Draft、Scheduled、Published、Archivedのいずれかです。 - 公開しても、お客様への通知は送られません。お客様がアプリや店舗のサイトを開いたときに表示されます。
- 投稿はビジネスアカウントに属し、すべての店舗で共有されます。
- 必要なスコープは
store.posts.writeです。
下田
工作人員
·
2026/11/12 13:26
您必須登入才能回覆。
登入