查询报告请求的正确格式是什么？

Question

大家下午好！我需要从 YouTube 的分析 API 中获取 estimatedMinutesWatched 参数。我在网上找了一些例子，比如this one，都是用的方法：

$api = $analytics->reports->query($id, $start_date, $end_date, $metric, $optparams);

但现在您需要将单个数组传递给该方法，这就是我出错的原因。

我不知道应该将哪个数组传递给 query()。这是我的代码：

 $client = new Google_Client();
        $client->setClientId($clientID);
        $client->setClientSecret($clientSecret);
        $client->setRedirectUri($redirectUri);
        $client->addScope("email");
        $client->addScope("profile");

// authenticate code from Google OAuth Flow
        if (isset($_GET['code'])) {
            $token = $client->fetchAccessTokenWithAuthCode($_GET['code']);
            $client->setAccessToken($token);
            $start_date = '2000-01-01';
            $end_date = '2021-01-01';
            $metrics = 'estimatedMinutesWatched';
            $channel_url='https://www.youtube.com/channel/UCqRTXU9O7v3KeJcQuxmEhaA';
            $ids = 'channel==' . $channel_url . '';
            $analytics = new Google_Service_YouTubeAnalytics($client);
            $optparams = array(
                'dimensions' => '7DayTotals',
                'sort' => 'day',
                'ids' => $ids,
                'start_date' => $start_date,
                'end_date' => $end_date,
                'metric'=>$metrics
            );
            $api = $analytics->reports->query($optparams);

            var_dump($api);
            die();

我得到的例外是：

(query) unknown parameter: 'start_date'

我知道我需要重写查询，但真的不知道该怎么做。

Answer 1

根据 YouTube 分析的官方文档Reports Query, the name of the date parameters are: startDate and endDate（注意驼峰式大小写）。

因此您的 API 调用应该如下所示：

$analytics = new Google_Service_YouTubeAnalytics($client);
$optparams = array(
    'dimensions' => '7DayTotals',
    'sort' => 'day',
    'ids' => $ids,
    'startDate' => $start_date,
    'endDate' => $end_date,
    'metrics' => $metrics
);
$api = $analytics->reports->query($optparams);

我还将 metric 参数更正为 metrics。

另请注意，ids 参数应包含 channel == CHANNEL_ID 形式的规范，但您的是 channel == CHANNEL_URL。只需将其替换为：

channel == UCqRTXU9O7v3KeJcQuxmEhaA 或 channel == MINE.

根据官方文档，假定 UCqRTXU9O7v3KeJcQuxmEhaA 是与在 OAuth 2.0 authentication/authorization 流程中授权您的应用程序的用户对应的渠道 ID。

查询报告请求的正确格式是什么？

What is the proper format of request for querying a report?

php

google-api

google-api-php-client

youtube-analytics-api