30 czerwca 2024 r. wycofamy poprzednią wersję Search Ads 360 Reporting API. Pamiętaj, że nie dotyczy to interfejsu Search Ads 360 Conversion API, który nadal będzie obsługiwany. Podczas programowania raportów w nowej wersji Search Ads 360 należy używać nowego interfejsu Search Ads 360 Reporting API.

Od kwietnia 2024 r. po wysłaniu żądania raportu będzie zwracany błąd nieobsługiwanej wersji ApiVersion. Więcej informacji znajdziesz tutaj.

Zdecydowanie zalecamy też przeniesienie wszystkich istniejących implementacji Search Ads 360 do nowego interfejsu API. Więcej informacji znajdziesz w artykułach Wprowadzenie i Przewodnik po migracji do nowego interfejsu Search Ads 360 Reporting API.

Ta strona została przetłumaczona przez Cloud Translation API.

Reports

Listę metod dla tego zasobu znajdziesz na końcu tej strony.

Reprezentacje zasobów

Raport DoubleClick Search. Ten obiekt zawiera żądanie raportu, niektóre metadane raportu, takie jak kod waluty, oraz wygenerowane wiersze lub pliki raportów.

{
  "kind": "doubleclicksearch#report",
  "id": string,
  "isReportReady": boolean,
  "request": {
    "reportScope": {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "adGroupId": long,
      "keywordId": long,
      "adId": long
    },
    "reportType": string,
    "columns": [
      {
        "columnName": string,
        "savedColumnName": string,
        "customDimensionName": string,
        "customMetricName": string,
        "headerText": string,
        "startDate": string,
        "endDate": string,
        "groupByColumn": boolean,
        "platformSource": string,
        "productReportPerspective": string
      }
    ],
    "timeRange": {
      "startDate": string,
      "endDate": string,
      "changedMetricsSinceTimestamp": datetime,
      "changedAttributesSinceTimestamp": datetime
    },
    "filters": [
      {
        "column": {
          "columnName": string,
          "savedColumnName": string,
          "customDimensionName": string,
          "customMetricName": string,
          "headerText": string,
          "startDate": string,
          "endDate": string,
          "groupByColumn": boolean,
          "platformSource": string,
          "productReportPerspective": string
        },
        "operator": string,
        "values": [
          (value)
        ]
      }
    ],
    "orderBy": [
      {
        "column": {
          "columnName": string,
          "savedColumnName": string,
          "customDimensionName": string,
          "customMetricName": string,
          "headerText": string,
          "startDate": string,
          "endDate": string,
          "groupByColumn": boolean,
          "platformSource": string,
          "productReportPerspective": string
        },
        "sortOrder": string
      }
    ],
    "includeDeletedEntities": boolean,
    "includeRemovedEntities": boolean,
    "verifySingleTimeZone": boolean,
    "downloadFormat": string,
    "statisticsCurrency": string,
    "startRow": integer,
    "rowCount": integer,
    "maxRowsPerFile": integer
  },
  "statisticsCurrencyCode": string,
  "statisticsTimeZone": string,
  "rowCount": integer,
  "files": [
    {
      "url": string,
      "byteCount": long
    }
  ],
  "rows": [
    {
      (key): (value)
    }
  ]
}

Nazwa usługi	Wartość	Opis
`files[]`	`list`	Tylko raport asynchroniczny. Zawiera listę wygenerowanych plików raportu po pomyślnym wygenerowaniu raportu.
`files[].byteCount`	`long`	Rozmiar tego pliku raportu w bajtach.
`files[].url`	`string`	Użyj tego adresu URL, aby pobrać plik raportu.
`id`	`string`	Tylko raport asynchroniczny. Identyfikator raportu.
`isReportReady`	`boolean`	Tylko raport asynchroniczny. Wartość prawda tylko wtedy, gdy raport został ukończony, a pliki raportu są gotowe do pobrania.
`kind`	`string`	Określa jako zasób raportu. Wartość: ustalony ciąg znaków `doubleclicksearch#report`.
`request`	`nested object`	Żądanie, które utworzyło raport. Pola opcjonalne, które nie zostały określone w pierwotnym żądaniu, są wypełniane wartościami domyślnymi.
`request.columns[]`	`list`	Kolumny do uwzględnienia w raporcie. Obejmuje to zarówno kolumny DoubleClick Search, jak i zapisane kolumny. W przypadku kolumn DoubleClick Search wymagany jest tylko parametr `columnName`. W przypadku zapisanych kolumn wymagany jest tylko parametr `savedColumnName`. Zarówno `columnName`, jak i `savedColumnName` nie mogą być ustawione w tej samej strofie. Maksymalna liczba kolumn na żądanie to 300.
`request.columns[].columnName`	`string`	Nazwa kolumny DoubleClick Search, która ma zostać uwzględniona w raporcie.
`request.columns[].customDimensionName`	`string`	Segmentuje raport według wymiaru niestandardowego. Zakres raportu musi być na poziomie reklamodawcy lub niższym, a wymiar niestandardowy musi być już skonfigurowany w Search Ads 360. W nazwie wymiaru niestandardowego widoczna w usłudze DoubleClick Search jest rozróżniana wielkość liter. Jeśli używasz go w raporcie konwersji, zwraca wartość określonego wymiaru niestandardowego dla danej konwersji, jeśli jest ustawiona. Ta kolumna nie dzieli raportu konwersji na segmenty.
`request.columns[].customMetricName`	`string`	Nazwa danych niestandardowych do uwzględnienia w raporcie. Zakres raportu musi być ograniczony do reklamodawcy lub niższego, a dane niestandardowe muszą być już skonfigurowane w Search Ads 360. W nazwie danych niestandardowych widoczna w Search Ads 360 jest rozróżniana wielkość liter.
`request.columns[].endDate`	`string`	Dzień promujący integrację społeczną w formacie RRRR-MM-DD. Jeśli podasz dane, zastąpią one ogólny zakres czasowy raportu w tej kolumnie. Wartość musi być podana razem z właściwością `startDate`.
`request.columns[].groupByColumn`	`boolean`	Tylko raport synchroniczny. Ustaw jako `true`, aby grupować według tej kolumny. Domyślna wartość to `false`.
`request.columns[].headerText`	`string`	tekst służący do identyfikacji tej kolumny w wynikach raportu; Jeśli nie zostanie określony, domyślna wartość to `columnName` lub `savedColumnName`. Pozwala to uniknąć kolizji między kolumnami DoubleClick Search a zapisanymi kolumnami o tej samej nazwie.
`request.columns[].platformSource`	`string`	Platforma służąca do dostarczania danych do wymiaru niestandardowego. Akceptowane wartości to „floodlight”.
`request.columns[].productReportPerspective`	`string`	Zwraca dane tylko o określonym typie aktywności związanej z produktem. Akceptowane wartości to: „`sold`”: zwraca dane tylko dotyczące sprzedanych produktów. „`advertised`”: zwraca dane tylko o produktach, które były reklamowane w kampanii produktowej, które mogły zostać sprzedane lub nie.
`request.columns[].savedColumnName`	`string`	Nazwa zapisanej kolumny do uwzględnienia w raporcie. Zakres raportu musi być ograniczony do reklamodawcy lub niższego. Zapisana kolumna musi być już utworzona w interfejsie DoubleClick Search.
`request.columns[].startDate`	`string`	Uwzględniaj datę w formacie RRRR-MM-DD. Jeśli podasz dane, zastąpią one ogólny zakres czasowy raportu w tej kolumnie. Wartość musi być podana razem z właściwością `endDate`.
`request.downloadFormat`	`string`	Format, w jakim ma być zwracany raport. Obecnie obsługiwane są formy `csv` i `tsv`.
`request.filters[]`	`list`	Lista filtrów, które można zastosować w raporcie. Maksymalna liczba filtrów na żądanie to 300.
`request.filters[].column`	`nested object`	Kolumna, według której zostanie zastosowany filtr. Może to być kolumna DoubleClick Search lub zapisana kolumna.
`request.filters[].column.columnName`	`string`	Nazwa kolumny DoubleClick Search, która ma zostać uwzględniona w raporcie.
`request.filters[].column.customDimensionName`	`string`	Segmentuje raport według wymiaru niestandardowego. Zakres raportu musi być na poziomie reklamodawcy lub niższym, a wymiar niestandardowy musi być już skonfigurowany w Search Ads 360. W nazwie wymiaru niestandardowego widoczna w usłudze DoubleClick Search jest rozróżniana wielkość liter. Jeśli używasz go w raporcie konwersji, zwraca wartość określonego wymiaru niestandardowego dla danej konwersji, jeśli jest ustawiona. Ta kolumna nie dzieli raportu konwersji na segmenty.
`request.filters[].column.customMetricName`	`string`	Nazwa danych niestandardowych do uwzględnienia w raporcie. Zakres raportu musi być ograniczony do reklamodawcy lub niższego, a dane niestandardowe muszą być już skonfigurowane w Search Ads 360. W nazwie danych niestandardowych widoczna w Search Ads 360 jest rozróżniana wielkość liter.
`request.filters[].column.endDate`	`string`	Dzień promujący integrację społeczną w formacie RRRR-MM-DD. Jeśli podasz dane, zastąpią one ogólny zakres czasowy raportu w tej kolumnie. Wartość musi być podana razem z właściwością `startDate`.
`request.filters[].column.groupByColumn`	`boolean`	Tylko raport synchroniczny. Ustaw jako `true`, aby grupować według tej kolumny. Domyślna wartość to `false`.
`request.filters[].column.headerText`	`string`	tekst służący do identyfikacji tej kolumny w wynikach raportu; Jeśli nie zostanie określony, domyślna wartość to `columnName` lub `savedColumnName`. Pozwala to uniknąć kolizji między kolumnami DoubleClick Search a zapisanymi kolumnami o tej samej nazwie.
`request.filters[].column.platformSource`	`string`	Platforma służąca do dostarczania danych do wymiaru niestandardowego. Akceptowane wartości to „floodlight”.
`request.filters[].column.productReportPerspective`	`string`	Zwraca dane tylko o określonym typie aktywności związanej z produktem. Akceptowane wartości to: „`sold`”: zwraca dane tylko dotyczące sprzedanych produktów. „`advertised`”: zwraca dane tylko o produktach, które były reklamowane w kampanii produktowej, które mogły zostać sprzedane lub nie.
`request.filters[].column.savedColumnName`	`string`	Nazwa zapisanej kolumny do uwzględnienia w raporcie. Zakres raportu musi być ograniczony do reklamodawcy lub niższego. Zapisana kolumna musi być już utworzona w interfejsie DoubleClick Search.
`request.filters[].column.startDate`	`string`	Uwzględniaj datę w formacie RRRR-MM-DD. Jeśli podasz dane, zastąpią one ogólny zakres czasowy raportu w tej kolumnie. Wartość musi być podana razem z właściwością `endDate`.
`request.filters[].operator`	`string`	Operator do użycia w filtrze. Listę dostępnych operatorów znajdziesz w opisie filtrów.
`request.filters[].values[]`	`list`	Lista wartości, według których ma być filtrowana wartość kolumny. Maksymalna liczba wartości filtra na żądanie to 300.
`request.includeDeletedEntities`	`boolean`	Określa, czy usunięte elementy powinny być uwzględnione w raporcie. Domyślna wartość to `false`. Wycofano. Zamiast niego używaj: `includeRemovedEntities`.
`request.includeRemovedEntities`	`boolean`	Określa, czy usunięte elementy powinny być uwzględnione w raporcie. Domyślna wartość to `false`.
`request.maxRowsPerFile`	`integer`	Tylko raport asynchroniczny. Maksymalna liczba wierszy w pliku raportu. Na podstawie tego pola duży raport jest dzielony na wiele plików. Akceptowane wartości to od `1000000` do `100000000` włącznie.
`request.orderBy[]`	`list`	Tylko raport synchroniczny. Lista kolumn i kierunków definiujących sortowanie wierszy raportu. Maksymalna liczba zamówień na żądanie to 300.
`request.orderBy[].column`	`nested object`	Kolumna, w której ma zostać wykonane sortowanie. Może to być kolumna zdefiniowana w usłudze DoubleClick Search lub kolumna zapisana.
`request.orderBy[].column.columnName`	`string`	Nazwa kolumny DoubleClick Search, która ma zostać uwzględniona w raporcie.
`request.orderBy[].column.customDimensionName`	`string`	Segmentuje raport według wymiaru niestandardowego. Zakres raportu musi być na poziomie reklamodawcy lub niższym, a wymiar niestandardowy musi być już skonfigurowany w Search Ads 360. W nazwie wymiaru niestandardowego widoczna w usłudze DoubleClick Search jest rozróżniana wielkość liter. Jeśli używasz go w raporcie konwersji, zwraca wartość określonego wymiaru niestandardowego dla danej konwersji, jeśli jest ustawiona. Ta kolumna nie dzieli raportu konwersji na segmenty.
`request.orderBy[].column.customMetricName`	`string`	Nazwa danych niestandardowych do uwzględnienia w raporcie. Zakres raportu musi być ograniczony do reklamodawcy lub niższego, a dane niestandardowe muszą być już skonfigurowane w Search Ads 360. W nazwie danych niestandardowych widoczna w Search Ads 360 jest rozróżniana wielkość liter.
`request.orderBy[].column.endDate`	`string`	Dzień promujący integrację społeczną w formacie RRRR-MM-DD. Jeśli podasz dane, zastąpią one ogólny zakres czasowy raportu w tej kolumnie. Wartość musi być podana razem z właściwością `startDate`.
`request.orderBy[].column.groupByColumn`	`boolean`	Tylko raport synchroniczny. Ustaw jako `true`, aby grupować według tej kolumny. Domyślna wartość to `false`.
`request.orderBy[].column.headerText`	`string`	tekst służący do identyfikacji tej kolumny w wynikach raportu; Jeśli nie zostanie określony, domyślna wartość to `columnName` lub `savedColumnName`. Pozwala to uniknąć kolizji między kolumnami DoubleClick Search a zapisanymi kolumnami o tej samej nazwie.
`request.orderBy[].column.platformSource`	`string`	Platforma służąca do dostarczania danych do wymiaru niestandardowego. Akceptowane wartości to „floodlight”.
`request.orderBy[].column.productReportPerspective`	`string`	Zwraca dane tylko o określonym typie aktywności związanej z produktem. Akceptowane wartości to: „`sold`”: zwraca dane tylko dotyczące sprzedanych produktów. „`advertised`”: zwraca dane tylko o produktach, które były reklamowane w kampanii produktowej, które mogły zostać sprzedane lub nie.
`request.orderBy[].column.savedColumnName`	`string`	Nazwa zapisanej kolumny do uwzględnienia w raporcie. Zakres raportu musi być ograniczony do reklamodawcy lub niższego. Zapisana kolumna musi być już utworzona w interfejsie DoubleClick Search.
`request.orderBy[].column.startDate`	`string`	Uwzględniaj datę w formacie RRRR-MM-DD. Jeśli podasz dane, zastąpią one ogólny zakres czasowy raportu w tej kolumnie. Wartość musi być podana razem z właściwością `endDate`.
`request.orderBy[].sortOrder`	`string`	Kierunek sortowania, który jest wartością `ascending` lub `descending`.
`request.reportScope`	`object`	RaportZakres to zbiór identyfikatorów służących do określania podzbioru elementów, które będą zwracane w raporcie. Wymagana jest pełna historia identyfikatorów z najniższego poziomu zakresu żądanego przez agencję.
`request.reportScope.adGroupId`	`long`	Identyfikator grupy reklam DS.
`request.reportScope.adId`	`long`	Identyfikator reklamy DS.
`request.reportScope.advertiserId`	`long`	Identyfikator reklamodawcy DS.
`request.reportScope.agencyId`	`long`	Identyfikator agencji w DS.
`request.reportScope.campaignId`	`long`	Identyfikator kampanii DS.
`request.reportScope.engineAccountId`	`long`	Identyfikator konta wyszukiwarki DS.
`request.reportScope.keywordId`	`long`	Identyfikator słowa kluczowego DS.
`request.reportType`	`string`	Określa typ wierszy zwracanych w raporcie. Jeśli np. podasz `reportType: keyword`, każdy wiersz raportu będzie zawierał dane o słowie kluczowym. Kolumny dostępne dla poszczególnych typów znajdziesz w informacjach o typach raportów.
`request.rowCount`	`integer`	Tylko raport synchroniczny. maksymalna liczba wierszy do zwrócenia; są pomijane dodatkowe wiersze. Akceptowane wartości to od `0` do `10000` włącznie. Domyślna wartość to `10000`.
`request.startRow`	`integer`	Tylko raport synchroniczny. Indeks liczony od zera dla pierwszego wiersza do zwrócenia. Akceptowane wartości to od `0` do `50000` włącznie. Domyślna wartość to `0`.
`request.statisticsCurrency`	`string`	Określa walutę, w której zostanie zwrócona kwota pieniężna. Możliwe wartości: `usd`, `agency` (prawidłowe, jeśli raport jest ograniczony do agencji lub niższego zakresu), `advertiser` (ważny, jeśli raport ma zakres ograniczony do reklamodawcy * lub węższego) oraz `account` (obowiązują, jeśli raport ma zakres ograniczony do konta wyszukiwarki lub niższym).
`request.timeRange`	`object`	Jeśli w raporcie zażądają danych, ten argument będzie używany do ograniczenia danych do określonego zakresu czasowego.
`request.timeRange.changedAttributesSinceTimestamp`	`datetime`	Sygnatura czasowa UTC uwzględniająca warunki w formacie RFC, np. `2013-07-16T10:16:23.555Z`. Zapoznaj się z dodatkowymi materiałami na temat działania raportów o zmienionych atrybutach.
`request.timeRange.changedMetricsSinceTimestamp`	`datetime`	Sygnatura czasowa UTC uwzględniająca warunki w formacie RFC, np. `2013-07-16T10:16:23.555Z`. Zobacz dodatkowe materiały na temat tego, jak działają raporty o zmienionych danych.
`request.timeRange.endDate`	`string`	Uwzględniaj datę w formacie RRRR-MM-DD.
`request.timeRange.startDate`	`string`	Uwzględniaj datę w formacie RRRR-MM-DD.
`request.verifySingleTimeZone`	`boolean`	W przypadku wartości `true` raport zostanie utworzony tylko wtedy, gdy wszystkie żądane dane statystyczne pochodzą z jednej strefy czasowej. Domyślna wartość to `false`.
`rowCount`	`integer`	Liczba wierszy raportu wygenerowanych przez raport (bez nagłówków).
`rows[]`	`list`	Tylko raport synchroniczny. Wygenerowano wiersze raportu.
`rows[].(key)`	`any value`	Wskazuje kolumny reprezentowane w tym wierszu. Oznacza to, że każdy klucz odpowiada kolumnie z niepustą komórką w tym wierszu.
`statisticsCurrencyCode`	`string`	Kod waluty wszystkich wartości pieniężnych wygenerowanych w raporcie, w tym wartości ustawionych przez użytkowników (np. ustawień stawki za słowo kluczowe) i danych (np. kosztów i przychodów). Kod waluty raportu jest określany przez pole `statisticsCurrency` żądania raportu.
`statisticsTimeZone`	`string`	Załóżmy, że wszystkie statystyki raportu pochodzą z tej samej strefy czasowej. W przeciwnym razie pole jest nieskonfigurowane.

Metody

generuj: Generuje i zwraca raport natychmiast.
pobierz: Ankietuje stan prośby o raport.
getFile: Pobiera plik raportu zakodowany w formacie UTF-8.
getIdMappingFile: Pobiera plik CSV (zakodowany w formacie UTF-8) zawierający mapowania identyfikatorów między poprzednią a nową wersją Search Ads 360. W przypadku żądanego reklamodawcy plik zawiera wszystkie elementy podrzędne (np. konta wyszukiwarek, kampanie, grupy reklam itp.), które istnieją zarówno w poprzedniej, jak i w nowej wersji Search Ads 360.
prośbę: Wstawia żądanie raportu do systemu raportowania.