Method: curators.reports.results.fetchRows

Возвращает строки результатов из завершенного отчета. Вызывающая сторона должна предварительно вызвать RunReport и дождаться завершения этой операции. Строки будут возвращены в порядке, указанном в параметре sorts определения отчета.

HTTP-запрос

GET https://curationpartners.googleapis.com/v1/{name=curators/*/reports/*/results/*}:fetchRows

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
name

string

Полученные результаты отчета. Формат: curators/{accountId}/reports/{reportId}/results/{reportResultId}

Параметры запроса

Параметры
pageSize

integer

Необязательный параметр. Максимальное количество возвращаемых строк. Сервис может вернуть меньше этого значения. Если параметр не указан, будет возвращено не более 1000 строк. Максимальное значение — 10 000; значения больше 10 000 будут уменьшены до 10 000.

pageToken

string

Необязательный параметр. Токен страницы, полученный из предыдущего вызова results.fetchRows . Укажите его, чтобы получить вторую и последующие партии строк.

Текст запроса

Тело запроса должно быть пустым.

Ответный текст

Ответное сообщение для конечной точки получения строк результатов отчета.

В случае успеха тело ответа будет содержать данные следующей структуры:

JSON-представление
{
  "rows": [
    {
      object (Row)
    }
  ],
  "runTime": string,
  "dateRanges": [
    {
      object (FixedDateRange)
    }
  ],
  "totalRowCount": integer,
  "nextPageToken": string
}
Поля
rows[]

object ( Row )

До pageSize строк данных отчета.

runTime

string ( Timestamp format)

Время, когда отчет был запланирован к запуску. Для незапланированных отчетов это время, когда отчет был запрошен к запуску.

Используется RFC 3339, согласно которому сгенерированный вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

dateRanges[]

object ( FixedDateRange )

В отчет включены вычисленные фиксированные диапазоны дат. Возвращается только первая страница результатов (если pageToken не указан в запросе).

totalRowCount

integer

Общее количество строк, доступных в этом отчете. Полезно для постраничной навигации. Возвращается только с первой страницей результатов (если pageToken не включен в запрос).

nextPageToken

string

Токен, который можно отправить в качестве pageToken для получения следующей страницы. Если это поле опущено, последующих страниц не будет.

Области полномочий

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/curation-partners

Ряд

Строка данных отчета.

JSON-представление
{
  "dimensionValues": [
    {
      object (ReportValue)
    }
  ],
  "metricValueGroups": [
    {
      object (MetricValueGroup)
    }
  ]
}
Поля
dimensionValues[]

object ( ReportValue )

Порядок значений размеров совпадает с порядком размеров, указанным в запросе.

metricValueGroups[]

object ( MetricValueGroup )

Длина поля metricValueGroups будет равна длине поля dateRanges в ответе на запрос. Поле metricValueGroups упорядочено таким образом, что каждый индекс соответствует диапазону дат с одинаковым индексом. Например, для диапазона дат [x, y] длина поля metricValueGroups будет равна двум. Первая запись в metricValueGroups представляет метрики для даты x, а вторая запись в metricValueGroups — метрики для даты y.

MetricValueGroup

Содержит все запрошенные значения метрик для одного диапазона дат и набора значений измерений столбцов (возвращаемых в поле «Столбцы» ответа). Порядок метрик в каждом поле соответствует порядку метрик, указанному в запросе.

JSON-представление
{
  "primaryValues": [
    {
      object (ReportValue)
    }
  ]
}
Поля
primaryValues[]

object ( ReportValue )

Данные для основного значения метрики (PRIMARY MetricValueType).