# Vytváření úloh informací o produktu Google Shopping

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/merchant/google/product_info/task_post`

**Tags:** DataForSEO

Zařadí vyhledání jednoho konkrétního produktu Google Shopping a vrátí `id` úlohy. Produkt určete pomocí `product_id` a `gid` nebo `data_docid` z výsledku `get_dataforseo_merchant_google_products_fetch`. Celá tato rodina je asynchronní: odeslání vrátí `id` úlohy v `tasks[0].id` a nástroj pro načtení vrátí výsledek, jakmile je připraven. Načtěte pomocí `get_dataforseo_merchant_google_product_info_fetch`.

### Cenová reference

- Účtování: nahlášené náklady na odpověď.
- Referenční odhad požadavku: USD 0.012.
- Referenční multiplikátor zákazníka: 1.0. Neaplikujte jej znovu na zúčtovanou částku zákazníka.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

## Related links

- [endpoint Google Shopping Products](<https://docs.dataforseo.com/v3/merchant/google/products/task_post>)
- [tomto průvodci Centra nápovědy](<https://dataforseo.com/help-center/product-id-google-shopping>)
- [tomto průvodci Centra nápovědy](<https://dataforseo.com/help-center/whats-a-gid-in-google-shopping-api>)
- [Ceny](<https://dataforseo.com/pricing/merchant/google-shopping-api>)
- [Centru nápovědy](<https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api>)

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "product_id": {
            "type": "string",
            "description": "<em>jedinečný identifikátor produktu na Google Shopping</em><br><strong>povinné pole, pokud není zadán <code>data_docid</code> nebo <code>gid</code></strong><br>pro optimální výsledky doporučujeme zadat <code>product_id</code> společně s <code>data_docid</code> a <code>gid</code>;<br>tuto hodnotu pro určitý produkt získáte samostatným požadavkem na endpoint Google Shopping Products<br>příklad:<br><code>4485466949985702538</code><br>další informace o parametru najdete v tomto průvodci Centra nápovědy"
          },
          "data_docid": {
            "type": "string",
            "description": "<em>jedinečný identifikátor datového prvku SERP</em><br><strong>povinné pole, pokud není zadán <code>product_id</code> nebo <code>gid</code></strong><br>pro optimální výsledky doporučujeme zadat <code>data_docid</code> společně s <code>product_id</code> a <code>gid</code>;<br>tuto hodnotu pro určitý prvek získáte samostatným požadavkem na endpoint Google Shopping Products<br>příklad:<br><code>13071766526042404278</code>"
          },
          "gid": {
            "type": "string",
            "description": "<em>globální identifikátor produktu na Google Shopping</em><br><strong>povinné pole, pokud není zadán <code>product_id</code> nebo <code>data_docid</code></strong><br>pro optimální výsledky doporučujeme zadat <code>gid</code> společně s <code>product_id</code> a <code>data_docid</code>;<br>tuto hodnotu pro určitý produkt získáte samostatným požadavkem na endpoint Google Shopping Products<br>příklad:<br><code>4702526954592161872</code><br>další informace o parametru najdete v tomto průvodci Centra nápovědy"
          },
          "priority": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>priorita úlohy</em><br>volitelné pole<br>může nabývat následujících hodnot:<br>1 – normální priorita provedení (nastaveno ve výchozím nastavení)<br>2 – vysoká priorita provedení. Za úlohy s vysokou prioritou provedení bude účtován příplatek.<br>Náklady lze vypočítat na stránce Ceny."
          },
          "location_name": {
            "type": "string",
            "description": "<em>úplný název lokality</em><br><strong>povinné pole, pokud nezadáte</strong> <code>location_code</code> nebo <code>location_coordinate</code><br><strong>pokud toto pole použijete, nemusíte zadávat <code>location_code</code> ani <code>location_coordinate</code></strong><br>seznam dostupných lokalit Google Shopping s jejich <code>location_name</code> získáte samostatným požadavkem na <code>https://api.dataforseo.com/v3/merchant/google/locations</code><br>příklad:<br><code class=\"long-string\">London,England,United Kingdom</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>kód lokality</em><br><strong>povinné pole, pokud nezadáte</strong> <code>location_name</code> nebo <code>location_coordinate</code><br><strong>pokud toto pole použijete, nemusíte zadávat <code>location_name</code> ani <code>location_coordinate</code></strong><br>seznam dostupných lokalit Google Shopping s jejich <code>location_code</code> získáte samostatným požadavkem na <code>https://api.dataforseo.com/v3/merchant/google/locations</code><br>příklad:<br><code class=\"long-string\">2840</code>"
          },
          "location_coordinate": {
            "type": "string",
            "description": "<em>GPS souřadnice lokality</em><br><strong>povinné pole, pokud nezadáte</strong> <code>location_name</code> nebo <code>location_code</code><br><strong>pokud toto pole použijete, nemusíte zadávat <code>location_name</code> ani <code>location_code</code></strong><br>parametr <code>location_coordinate</code> je nutné zadat ve formátu <em>\"latitude,longitude,radius\"</em><br>maximální počet desetinných míst pro <em>\"latitude\"</em> a <em>\"longitude\"</em>: 7<br>minimální hodnota pro <em>\"radius\"</em>: 199.9<br>příklad:<br><code class=\"long-string\">53.476225,-2.243572,200</code>"
          },
          "language_name": {
            "type": "string",
            "description": "<em>úplný název jazyka</em><br><strong>povinné pole, pokud nezadáte</strong> <code>language_code</code><br><strong>pokud toto pole použijete, nemusíte zadávat <code>language_code</code></strong><br>seznam dostupných jazyků Google Shopping s jejich <code>language_name</code> získáte samostatným požadavkem na <code>https://api.dataforseo.com/v3/merchant/google/languages</code><br>příklad:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": "string",
            "description": "<em>kód jazyka</em><br><strong>povinné pole, pokud nezadáte</strong> <code>language_name</code><br><strong>pokud toto pole použijete, nemusíte zadávat <code>language_name</code></strong><br>seznam dostupných jazyků Google Shopping s jejich <code>language_code</code> získáte samostatným požadavkem na <code>https://api.dataforseo.com/v3/merchant/google/languages</code><em><br></em>příklad:<em><br></em><code class=\"long-string\">en</code>"
          },
          "se_domain": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>doména vyhledávače</em><br>volitelné pole<br>relevantní doménu vyhledávače vybíráme automaticky podle zadané lokality a jazyka<br>v tomto poli však můžete nastavit vlastní doménu vyhledávače<br>příklad:<br><code><em>google.co.uk</code>, <code>google.com.au</code>, <code>google.de</code> atd."
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>uživatelem definovaný identifikátor úlohy</em><br>volitelné pole<br><em>limit znaků je 255</em><br>tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem<br>zadanou hodnotu <code>tag</code> najdete v objektu <code>data</code> odpovědi"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>URL pro odesílání výsledků úlohy</em><br>volitelné pole<br>po dokončení úlohy odešleme požadavek POST s výsledky komprimovanými ve formátu <code>gzip</code> na zadanou <code>postback_url</code><br>řetězec ‘$id’ můžete použít jako proměnnou <code>$id</code> a ‘$tag’ jako proměnnou <code>$tag</code> kódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty.<br>příklad:<br><code>http://your-server.com/postbackscript?id=$id</code><br><code>http://your-server.com/postbackscript?id=$id&amp;tag=$tag</code><br><strong>Poznámka:</strong> speciální znaky v <code>postback_url</code> budou kódovány v URL;<br>mj. znak <code>#</code> bude zakódován jako <code>%23</code><p>další informace najdete v Centru nápovědy"
          },
          "postback_data": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>datový typ postback_url</em><br>volitelné pole<br>odpovídá datovému typu, který bude odeslán na váš server<br>možné hodnoty:<br><code>advanced</code>"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>URL oznámení o dokončené úloze</em><br>volitelné pole<br>po dokončení úlohy vás upozorníme požadavkem GET odeslaným na zadanou URL<br>řetězec ‘$id’ můžete použít jako proměnnou <code>$id</code> a ‘$tag’ jako proměnnou <code>$tag</code> kódovanou v URL. Před odesláním požadavku nastavíme potřebné hodnoty<br>příklad:<br><code>http://your-server.com/pingscript?id=$id</code><br><code>http://your-server.com/pingscript?id=$id&amp;tag=$tag</code><br><strong>Poznámka:</strong> speciální znaky v <code>pingback_url</code> budou kódovány v URL;<br>mj. znak <code>#</code> bude zakódován jako <code>%23</code><p>další informace najdete v Centru nápovědy"
          }
        },
        "example": [
          {
            "language_code": "en",
            "location_code": 2840,
            "product_id": "1113158713975221117"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "language_code": "en",
      "location_code": 2840,
      "product_id": "1113158713975221117"
    }
  ]
}
```

## Responses

### 200 — Úspěšná operace

Headers:
- `X-Request-Id` (string) — Identifikátor požadavku, který je třeba uvést při kontaktování podpory Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskPostResponseInfo"
    }
  ]
}
```

### 400 — Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.

### 401 — Je vyžadován platný API klíč Felo.

### 402 — V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.

### 403 — Účet nemá oprávnění tuto operaci provést.

### 429 — Byl dosažen limit požadavků nebo útraty.

### 502 — Služba nemohla požadavek dokončit.

### 503 — API nebo fakturační služba je dočasně nedostupná.

### 504 — Při zpracování požadavku vypršel časový limit služby.

### default — Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "aktuální verze API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "obecný kód stavu\núplný seznam kódů odpovědí najdete zde"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "obecná informační zpráva\núplný seznam obecných informačních zpráv najdete zde"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "celková doba provádění, sekundy"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "celkové náklady na úlohy, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "počet úloh v poli tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "počet úloh v poli tasks vrácených s chybou",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "identifikátor úlohy\njedinečný identifikátor úlohy v našem systému ve formátu UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "stavový kód úlohy\nvygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000\núplný seznam kódů odpovědí najdete zde"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "informační zpráva úlohy\núplný seznam obecných informačních zpráv najdete zde"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "doba provedení, sekundy"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "celkové náklady na úlohy, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "počet prvků v poli result",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "cesta URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "obsahuje stejné parametry, které jste zadali v požadavku POST"
    }
  }
}
```

### Response36Afe1097B20_MerchantGoogleProductInfoTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskPostResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskPostTaskInfo"
              }
            ]
          },
          "description": "<em>pole úloh</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_MerchantGoogleProductInfoTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_MerchantGoogleProductInfoTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>pole výsledků</em><br>v tomto případě bude hodnota <code>null</code>"
        }
      }
    }
  ]
}
```
