---
title: Ürün etiketleri
description: Ürün etiketlerini yönetin.
full: true
---

## ProductTag nesnesi [#ProductTag]

**`ProductTag`** (v1 · v2)

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `createdAt` | `Timestamp` | Kaydın oluşturulma zamanı (milisaniye cinsinden Unix zaman damgası). |
| `deleted` | `Boolean!` | Kaydın silinmiş olup olmadığı. |
| `id` | `String!` | Kaydın ID değeri. |
| `name` | `String!` | Ürün etiketinin adı. |
| `translations` | `[ProductTagTranslation!]` | Ürün etiketinin adı. |
| `updatedAt` | `Timestamp` | Kaydın son güncellenme zamanı (milisaniye cinsinden Unix zaman damgası). |

Örnek (temsili):

```json
{
  "createdAt": 1735725600000,
  "deleted": false,
  "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
  "name": "Örnek",
  "translations": [
    {
      "description": "Örnek açıklama",
      "locale": "tr",
      "name": "Örnek"
    }
  ],
  "updatedAt": 1735725600000
}
```

## Ürün etiketlerini listele [#listProductTag]

**`listProductTag`** (query, v1 · v2)

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `id` | `StringFilterInput` | Kaydın ID değeri. |
| `name` | `StringFilterInput` | Ürün etiketi adına göre filtreleyebilirsiniz. |
| `search` | `String` | Serbest metin araması. |
| `updatedAt` | `DateFilterInput` | Kaydın son güncellenme zamanı (milisaniye cinsinden Unix zaman damgası). |

Dönen değer: `[ProductTag!]!`

Örnek istek - Ürün etiketlerini listeleme (`POST https://api.myikas.com/api/v2/admin/graphql`):

```graphql
{
  listProductTag {
    id
    name
  }
}
```

Örnek yanıt:

```json
{
  "data": {
    "listProductTag": [
      {
        "id": "8cf68e80-82ac-437f-9dd5-dc88cfef8293",
        "name": "Tag name"
      }
    ]
  }
}
```

## Ürün etiketi oluştur [#createProductTag]

**`createProductTag`** (mutation, v2)

ProductTag oluşturan mutation.

Yalnızca v2 endpoint'inde: `https://api.myikas.com/api/v2/admin/graphql`

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `input` (zorunlu) | `CreateProductTagInput!` | İşlemin girdi nesnesi. |

Dönen değer: `ProductTag!`

Örnek istek - Ürün etiketi oluşturma (`POST https://api.myikas.com/api/v2/admin/graphql`):

Ürünleri kampanya veya koleksiyon bazında gruplamak için yeni bir etiket oluşturur.

```graphql
mutation CreateProductTag($input: CreateProductTagInput!) {
  createProductTag(input: $input) {
    id
    name
    translations {
      locale
      name
    }
    createdAt
  }
}
```

```json
{
  "input": {
    "name": "Yeni Sezon",
    "translations": [
      {
        "locale": "en",
        "name": "New Season"
      }
    ]
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "createProductTag": {
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "name": "Örnek",
      "translations": [
        {
          "locale": "tr",
          "name": "Örnek"
        }
      ],
      "createdAt": 1735725600000
    }
  }
}
```

## Ürün etiketini güncelle [#updateProductTag]

**`updateProductTag`** (mutation, v2)

ProductTag güncelleyen mutation.

Yalnızca v2 endpoint'inde: `https://api.myikas.com/api/v2/admin/graphql`

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `input` (zorunlu) | `UpdateProductTagInput!` | İşlemin girdi nesnesi. |

Dönen değer: `ProductTag!`

Örnek istek - Ürün etiketini güncelleme (`POST https://api.myikas.com/api/v2/admin/graphql`):

Mevcut bir etiketin adını değiştirir. Etiketin atandığı ürünler yeni adla görünmeye devam eder.

```graphql
mutation UpdateProductTag($input: UpdateProductTagInput!) {
  updateProductTag(input: $input) {
    id
    name
    updatedAt
  }
}
```

```json
{
  "input": {
    "id": "840345c1-f69a-40ca-9fa0-52d55f6f52ce",
    "name": "Yaz Koleksiyonu 2026"
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "updateProductTag": {
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "name": "Örnek",
      "updatedAt": 1735725600000
    }
  }
}
```

## Ürün etiketi kaydet [#saveProductTag]

**`saveProductTag`** (mutation, v1)

Bu API ile ürün etiketi oluşturabilir veya güncelleyebilirsiniz.

Yalnızca v1 endpoint'inde: `https://api.myikas.com/api/v1/admin/graphql`. v2 karşılığı: `createProductTag`, `updateProductTag`.

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `input` (zorunlu) | `ProductTagInput!` | İşlemin girdi nesnesi. |

Dönen değer: `ProductTag!`

Örnek istek - Ürün etiketi kaydetme (`POST https://api.myikas.com/api/v1/admin/graphql`):

v1 sürümünde ürün etiketi oluşturur; `id` gönderildiğinde mevcut etiket güncellenir.

```graphql
mutation SaveProductTag($input: ProductTagInput!) {
  saveProductTag(input: $input) {
    id
    name
    createdAt
    updatedAt
  }
}
```

```json
{
  "input": {
    "name": "Outlet"
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "saveProductTag": {
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "name": "Örnek",
      "createdAt": 1735725600000,
      "updatedAt": 1735725600000
    }
  }
}
```

## Ürün etiketlerini sil [#deleteProductTagList]

**`deleteProductTagList`** (mutation, v1 · v2)

ProductTag silen mutation.

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `idList` (zorunlu) | `[String!]!` | İşlem yapılacak kayıtların ID listesi. |

Dönen değer: `Boolean!`

Örnek istek - Ürün etiketlerini silme (`POST https://api.myikas.com/api/v2/admin/graphql`):

Süresi biten kampanya etiketlerini tek istekte siler.

```graphql
mutation DeleteProductTagList($idList: [String!]!) {
  deleteProductTagList(idList: $idList)
}
```

```json
{
  "idList": [
    "c8dd9648-45cb-457e-910d-74e122450935",
    "9e55fbdb-f066-44a0-a510-28bb2b6f8de7"
  ]
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "deleteProductTagList": true
  }
}
```