REST Resource: customers.analysisQueries

Zasób: AnalysisQuery

Określa zapytanie analityczne, które można wykonać w Centrum danych reklam.

Zapis JSON 
{
  "name": string,
  "title": string,
  "queryText": string,
  "parameterTypes": {
    string: {
      object (ParameterType)
    },
    ...
  },
  "mergeSpec": {
    object (MergeSpec)
  },
  "queryState": enum (QueryState),
  "updateTime": string,
  "updateEmail": string,
  "createTime": string,
  "createEmail": string,
  "queryShare": [
    {
      object (QueryShare)
    }
  ],

  // Union field filtered_row can be only one of the following:
  "filteredRowSummary": {
    object (FilteredRowSummary)
  },
  "generateFilteredRowSummaryAutomatically": boolean
  // End of list of possible types for union field filtered_row.
}
Pola
name

string

Nazwa, która jednoznacznie identyfikuje zapytanie. Ma ona format customer/[customerId]/analysisQuery/[resource_id], np. 'customers/123/analysisQuery/abcd1234'. Identyfikator zasobu jest generowany przez serwer.
title

string

Tytuł zapytania, który jest unikalny w obrębie jednego klienta i typu zapytania w Centrum danych reklam.
queryText

string

Tekst zapytania napisany w standardowej wersji SQL. Zobacz https://cloud.google.com/bigquery/docs/reference/standard-sql/.
parameterTypes

map (key: string, value: object (ParameterType))

Dodatkowe parametry oczekiwane przez zapytanie. Mapuje każdą nazwę argumentu na jej typ.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
mergeSpec
(deprecated)

object (MergeSpec)

Instrukcje scalania wierszy Jeśli ta opcja jest dostępna, wszystkie wiersze, które zostałyby usunięte ze względu na ochronę prywatności, zostaną połączone w 1 scalony wiersz. Jeśli scalony wiersz spełnia wymagania dotyczące prywatności, ostateczne dane są widoczne w ostatecznej wersji pliku.
queryState

enum (QueryState)

Stan zapytania.
updateTime

string (Timestamp format)

Czas ostatniej aktualizacji zapytania.

Sygnatura czasowa w formacie RFC3339 UTC &Zulu" z rozdzielczością nanosekundy i do 9 cyfr po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
updateEmail

string

Adres e-mail użytkownika, który jako ostatni zaktualizował zapytanie.
createTime

string (Timestamp format)

Czas utworzenia zapytania.

Sygnatura czasowa w formacie RFC3339 UTC &Zulu" z rozdzielczością nanosekundy i do 9 cyfr po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
createEmail

string

Adres e-mail użytkownika, który utworzył zapytanie.
queryShare[]

object (QueryShare)

Wskazuje, jak można udostępnić zapytanie poza właścicielem klienta Ads Data Hub.
Pole związkowe filtered_row. Instrukcje scalania wierszy filtered_row może mieć tylko jedną z tych wartości:
filteredRowSummary

object (FilteredRowSummary)

Określ, jak połączyć wiersze usunięte ze względu na ochronę prywatności w jeden scalony wiersz. Scalony wiersz będzie uwzględniany w ostatnich wynikach, jeśli scalony wiersz będzie spełniał wymagania dotyczące prywatności.
generateFilteredRowSummaryAutomatically

boolean

Jeśli pole ma wartość Prawda, filtrowane podsumowanie jest generowane automatycznie.

Scalenie

Scal instrukcje dotyczące schematu wyniku zapytania analitycznego.

Zapis JSON 
{
  "columns": {
    string: {
      object (MergeColumn)
    },
    ...
  }
}
Pola
columns

map (key: string, value: object (MergeColumn))

Instrukcje scalania każdej kolumny oparte na nazwie. Wszystkie brakujące kolumny będą traktowane jako BGP_TYPE_UNSPECIFIED.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Scal kolumnę

Scal instrukcje dla pojedynczej kolumny wyjściowej.

Zapis JSON 
{
  "type": enum (MergeType),
  "value": {
    object (ParameterValue)
  }
}
Pola
type

enum (MergeType)

Metoda używana do łączenia wartości z kolumny.
value

object (ParameterValue)

Wartość stała (używana tylko w przypadku typu Stałe scalanie).

Typ scalania

Wszystkie obsługiwane operacje na scalaniu kolumn.

Wartości w polu enum
MERGE_TYPE_UNSPECIFIED Nieokreślony typ scalania. Scalona wartość kolumny będzie mieć wartość NULL.
CONSTANT Zastąp wartość scalonej kolumny określoną stałą.
SUM Użyj sumy wartości scalonych kolumn.

Podsumowanie filtra

Scal instrukcje dotyczące schematu wyniku zapytania analitycznego.

Zapis JSON 
{
  "columns": {
    string: {
      object (ColumnSummaryRule)
    },
    ...
  }
}
Pola
columns

map (key: string, value: object (ColumnSummaryRule))

Instrukcje scalania każdej kolumny oparte na nazwie. Brakujące kolumny będą traktowane jako SUMMARY_TYPE_UNSPECIFIED.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Regułapodsumowania kolumn

Scal instrukcje dla pojedynczej kolumny wyjściowej.

Zapis JSON 
{
  "type": enum (SummaryType),
  "value": {
    object (ParameterValue)
  }
}
Pola
type

enum (SummaryType)

Metoda używana do łączenia wartości z kolumny.
value

object (ParameterValue)

Wartość stała (tylko w przypadku typu podsumowania Stała).

Typ podsumowania

Wszystkie obsługiwane operacje na scalaniu kolumn.

Wartości w polu enum
SUMMARY_TYPE_UNSPECIFIED Nieokreślony typ podsumowania. Wartość w kolumnie podsumowania będzie wynosić NULL.
CONSTANT Zastąp wartość scalonej kolumny określoną stałą.
SUM Użyj sumy wartości scalonych kolumn.

Metody

create

 Tworzy zapytanie analityczne na potrzeby późniejszego wykonania.

delete

 Usuwa zapytanie analityczne.

get

 Pobiera żądane zapytanie analityczne.

list

 Wyświetla listę analiz analitycznych należących do określonego klienta.

patch

 Aktualizuje istniejące zapytanie analityczne.

start

 Uruchamia wykonanie zapisanego zapytania analizy.

startTransient

 Rozpoczyna wykonywanie zapytania tymczasowego analizy.

validate

 Przeprowadza sprawdzanie statycznego zapytania.