サポート終了と代替手段への移行
2022/02/20に、Google マイビジネス v4.9のaccounts.locations.reportInsightsとaccounts.locations.localPosts.reportInsightsは廃止となるため、前者については、Google Business Profile Performance API v1locations.getDailyMetricsTimeSeriesで置き換える必要があります（後者は代替手段なし）。
accounts.locations.reportInsightsとaccounts.locations.localPosts.reportInsightsについては、時刻については RFC3339 UTC のZulu形式のタイムスタンプ が用いられていますが、locations.getDailyMetricsTimeSeriesに関しては、公式サイトを見ると以下の記載があります。
TimeOfDay
1 日のうちの時刻を表します。日付とタイムゾーンは意味を持たないか、他の場所で指定されています。
書き方が曖昧すぎて、どこのタイムゾーンを基準にしているのか、わからない。。
困りました。。
解決方法
自分は調査に半日強かかってしまいましたが、、
サポート終了スケジュール | Google Business Profile APIs
を見ればわりと簡単なことで、accounts.locations.reportInsightsとlocations.getDailyMetricsTimeSeriesの対応する項目を任意の期間で取得して、比較すればよいだけのお話でした。
比較対象となるのは、以下3項目です。
| accounts.locations.reportInsights | locations.getDailyMetricsTimeSeries | 意味 |
|---|---|---|
| ACTIONS_WEBSITE | WEBSITE_CLICKS | ウェブサイトがクリックされた回数 |
| ACTIONS_PHONE | CALL_CLICKS | 通話ボタンがクリックされた回数 |
| ACTIONS_DRIVING_DIRECTIONS | BUSINESS_DIRECTION_REQUESTS | 受信した予約の数 |
accounts.locations.reportInsightsは時分秒まで、locations.getDailyMetricsTimeSeriesについては、日付を指定してAPIを叩き、前者の時刻指定をずらしながら、後者と上記3項目が一致する時刻を探します。
accounts.locations.reportInsights
https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:reportInsights
送信時に指定する項目（POST）
- locationName,
- 開始日時、終了日時
locations.getDailyMetricsTimeSeries
https://businessprofileperformance.googleapis.com/v1/locations/12345:getDailyMetricsTimeSeries?dailyMetric=WEBSITE_CLICKS&dailyRange.start_date.year=2022&dailyRange.start_date.month=12&dailyRange.start_date.day=1&dailyRange.end_date.year=2022&dailyRange.end_date.month=12&dailyRange.end_date.day=1
送信時に指定する項目（GET）
- locationName
- dailyMetric
- 開始日、終了日
自分の使用環境の場合は、前者の前日15:00～当日15:00まで（例: 10/12 15:00 ～10/13 15:00）の値が、後者の当日（10/13）の値と一致していたため、タイムゾーンは日本ということになりました。
終わりに
Googleさん、書き方わかりにくすぎるやろ。。
せめてどうやったら基準となるタイムゾーンを確認できるか、書いてくれることを切に望みます。