1
回答済み API

お知らせ(投稿)APIの scheduledAt はどのタイムゾーンですか?

グレープ · 2569/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 です。
下田 เจ้าหน้าที่ · 2569/11/12 13:26

คุณต้องเข้าสู่ระบบก่อนจึงจะตอบได้

เข้าสู่ระบบ