v0.2.0-beta

OpenAPI 3.1.0

Tworzenie zadań SERP wyszukiwania Google Ads

Felo API Support

MIT

Serwer

https://openapi.felo.ai

Biblioteki klienckie

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operacje

post/v1/beta/dataforseo/serp/google/ads_search/task_post

Tworzenie zadań SERP wyszukiwania Google Ads

Kolejkuje reklamy wyświetlane dla słowa kluczowego w Google i zwraca id zadania w tasks[0].id. Opakowane w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200. Wersja na żywo odpowiada natychmiast i jest prostsza dla pojedynczego zapytania; kolejkuj, gdy partia przekroczyłaby czas wywołania narzędzia.

Cennik referencyjny

Rozliczanie: zgłoszony koszt odpowiedzi.
Szacunek referencyjny dla żądania: USD 0.02.
Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść

application/json

Typ: array (object | null)[]
- advertiser_ids
  Typ: array string[]
  
  identyfikatory reklamodawców
  
  pole wymagane, jeśli target nie jest określony
  
  w tej tablicy możesz podać maksymalnie 25 wartości;
  
  wartości advertiser_ids dla tego parametru znajdziesz w endpoincie Google Ads Advertisers;
- date_from
  Typ: string
  
  data początkowa zakresu czasu
  
  pole opcjonalne
  
  pole wymagane, jeśli podano date_to;
  
  format daty: "yyyy-mm-dd"
  
  wartość minimalna: 2018-05-31
  
  wartość maksymalna: dzisiejsza data
  
  przykład:
  
  "2020-01-01"
- date_to
  Typ: string
  
  data końcowa zakresu czasu
  
  pole opcjonalne
  
  pole wymagane, jeśli podano date_from;
  
  format daty: "yyyy-mm-dd"
  
  wartość minimalna: 2018-05-31
  
  wartość maksymalna: dzisiejsza data
  
  przykład:
  
  "2020-01-01"
- depth
  Typ: integer | null
  
  głębokość parsowania
  
  pole opcjonalne
  
  liczba wyników w SERP
  
  wartość domyślna: 40
  
  wartość maksymalna: 700
  
  Twoje konto zostanie obciążone za każdy SERP zawierający do 40 wyników;
  Ustawienie głębokości powyżej 40 może wiązać się z dodatkowymi opłatami jeśli wyszukiwarka zwróci więcej niż 40 wyników;
  
  Koszt można obliczyć na stronie Cennik.
- format
  Typ: string | null
  
  format reklamy
  
  pole opcjonalne
  
  możliwe wartości: all, text, image, video
- location_code
  Typ: integer | null
  
  kod lokalizacji wyszukiwarki
  
  pole opcjonalne
  
  jeśli używasz tego pola, nie musisz podawać location_name lub location_coordinate
  
  listę dostępnych lokalizacji wyszukiwarek wraz z ich location_code można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/google/ads_search/locations
  
  przykład:
  
  2840
  
  Uwaga: jeśli nie podasz location_name, location_code lub location_coordinate, reklamy będą wyszukiwane we wszystkich dostępnych lokalizacjach
- location_coordinate
  Typ: string | null
  
  współrzędne GPS lokalizacji
  
  pole opcjonalne
  
  jeśli używasz tego pola, nie musisz podawać location_name lub location_code
  
  przykład:
  
  52.6178549,-155.352142
  
  Uwaga: jeśli nie podasz location_name, location_code lub location_coordinate, reklamy będą wyszukiwane we wszystkich dostępnych lokalizacjach
- location_name
  Typ: string | null
  
  pełna nazwa lokalizacji wyszukiwarki
  
  pole opcjonalne
  
  jeśli używasz tego pola, nie musisz podawać location_code lub location_coordinate
  
  listę dostępnych lokalizacji wyszukiwarki wraz z ich location_name można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/google/ads_search/locations
  
  przykład:
  
  London,England,United Kingdom
  
  Uwaga: jeśli nie podasz location_name, location_code lub location_coordinate, reklamy będą wyszukiwane we wszystkich dostępnych lokalizacjach
- pingback_url
  Typ: string | null
  
  adres URL powiadomienia o zakończonym zadaniu
  
  pole opcjonalne
  
  po zakończeniu zadania powiadomimy Cię żądaniem GET wysłanym na podany adres URL
  
  możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag zakodowanej w adresie URL. Przed wysłaniem żądania ustawimy wymagane wartości.
  
  przykład:
  
  http://your-server.com/pingscript?id=$id
  
  http://your-server.com/pingscript?id=$id&tag=$tag
  
  Uwaga: znaki specjalne w pingback_url zostaną zakodowane w adresie URL;
  
  m.in. znak # zostanie zakodowany jako %23
  
  więcej informacji w naszym Centrum pomocy
- platform
  Typ: string | null
  
  platforma reklamowa
  
  pole opcjonalne
  
  możliwe wartości: all, google_play, google_maps, google_search, google_shopping, youtube
  
  wartość domyślna: all
- postback_data
  Typ: string
  
  typ danych postback_url
  
  pole wymagane, jeśli podasz postback_url
  
  odpowiada funkcji użytej do ustawienia zadania
  
  możliwe wartości:
  
  advanced
- postback_url
  Typ: string | null
  
  adres URL do wysyłania wyników zadania
  
  pole opcjonalne
  
  po zakończeniu zadania wyślemy żądanie POST z wynikami skompresowanymi w formacie gzip na podany postback_url
  
  możesz użyć ciągu ‘$id’ jako zmiennej $id, a ‘$tag’ jako zmiennej $tag zakodowanej w adresie URL. Przed wysłaniem żądania ustawimy wymagane wartości.
  
  przykład:
  
  http://your-server.com/postbackscript?id=$id
  
  http://your-server.com/postbackscript?id=$id&tag=$tag
  
  Uwaga: znaki specjalne w postback_url zostaną zakodowane w adresie URL;
  
  m.in. znak # zostanie zakodowany jako %23
  
  więcej informacji znajdziesz w Centrum pomocy
- priority
  Typ: integer | null
  
  priorytet zadania
  
  pole opcjonalne
  
  może przyjmować następujące wartości:
  
  1 – normalny priorytet wykonania (ustawiany domyślnie)
  
  2 – wysoki priorytet wykonania
  
  Za zadania o wysokim priorytecie wykonania zostanie naliczona dodatkowa opłata.
  Koszt można obliczyć na stronie Cennik.
- tag
  Typ: string | null
  
  identyfikator zadania zdefiniowany przez użytkownika
  
  pole opcjonalne
  
  limit znaków to 255
  
  możesz użyć tego parametru, aby zidentyfikować zadanie i dopasować je do wyniku
  
  podaną wartość tag znajdziesz w obiekcie data odpowiedzi
- target
  Typ: string
  
  nazwa domeny
  
  pole wymagane, jeśli nie podano advertiser_ids
  
  nazwa domeny powiązana z kontem reklamodawcy

Odpowiedzi

200
Typ: object | null · Response36Afe1097B20_SerpGoogleAdsSearchTaskPostResponseInfo
cost
Typ: number | null Format: double

łączny koszt zadań, USD

status_code
Typ: integer | null

ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj

status_message
Typ: string | null

ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

tasks
Typ: array (object | null)[] | null

tablica zadań

Typ: object | null · Response36Afe1097B20_SerpGoogleAdsSearchTaskPostTaskInfo
cost
Typ: number | null Format: double

łączny koszt zadań, USD

data
Typ: object | null

zawiera te same parametry, które podano w żądaniu POST

propertyName
Typ: object | null
id
Typ: string | null

identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID

path
Typ: array (string | null)[] | null

ścieżka URL

result
Typ: object | null

tablica wyników
w tym przypadku wartością będzie null

result_count
Typ: integer | null Format: int64

liczba elementów w tablicy result

status_code
Typ: integer | null

kod statusu zadania wygenerowany przez DataForSEO; może mieścić się w następującym zakresie: 10000-60000 pełną listę kodów odpowiedzi znajdziesz tutaj

status_message
Typ: string | null

komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

time
Typ: string | null

czas wykonania, sekundy

tasks_count
Typ: integer | null Format: int64

liczba zadań w tablicy tasks

tasks_error
Typ: integer | null Format: int64

liczba zadań w tablicy tasks zwróconych z błędem

time
Typ: string | null

łączny czas wykonania, sekundy

version
Typ: string | null

bieżąca wersja interfejsu API
application/json
400

Nie można przetworzyć żądania. Sprawdź parametry żądania.
401

Wymagany jest prawidłowy klucz API Felo.
402

Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.
403

Konto nie ma uprawnień do wykonania tej operacji.
429

Osiągnięto limit żądań lub wydatków.
502

Usługa nie mogła ukończyć żądania.
503

API lub usługa rozliczeniowa jest tymczasowo niedostępna.
504

Upłynął limit czasu usługi podczas przetwarzania żądania.
default

Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

application/json

post/v1/beta/dataforseo/serp/google/ads_search/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ads_search/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_code": 2840,
    "platform": "google_search",
    "advertiser_ids": [
      "AR13752565271262920705",
      "AR02439908557932462081"
    ]
  }
]'

Pokaż schemat

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": null
    }
  ]
}

Operacja zakończona powodzeniem

Tworzenie zadań SERP wyszukiwania Google Ads

UwierzytelnianieRequired

DataForSEO

Tworzenie zadań SERP wyszukiwania Google Ads

Cennik referencyjny