Siparişlere, müşterilere ya da ürünlere toplu etiket ekleme
tagsAdd ile tek bir kayda mevcut etiketlerini silmeden etiket ekleyin ya da tagsAdd’i bir bulk mutation içinde çalıştırıp binlerce kaydı birden etiketleyin.
- API
- Admin GraphQL API
- İşlemler
- tagsAdd, bulkOperationRunMutation
- Erişim yetkisi
- Etiketlenen kayıt için yazma yetkisi (siparişler, müşteriler, ürünler vb.)
- Yerini aldığı REST çağrısı
- Tüm etiket metniyle PUT /admin/api/orders/{id}.json
- API sürümü
- 2026-10
- Son kontrol
Kısaca
Bir kaydı mevcut etiketlerine dokunmadan etiketlemek için tagsAdd’i kaydın ID’si ve yeni etiketlerle çağırın; siparişler, taslak siparişler, müşteriler, ürünler ve blog yazılarında çalışır. Binlerce kayıt için her kayda bir satır ({"id", "tags"}) yazdığınız JSONL dosyasını stagedUploadsCreate ile yükleyin ve tagsAdd’i bulkOperationRunMutation ile çalıştırın. tagsRemove da aynı şekilde çalışır.
Nasıl kullanılır
- Tek bir kayıt için TagOrder’ı GID’si ve eklenecek etiketlerle gönderin.
- Çok sayıda kayıt için her satırda bir {"id", "tags"} nesnesi olan tags.jsonl dosyasını yazın.
- Dosyayı staged upload tarifindeki gibi yükleyin ve key değerini saklayın.
- TagOrdersInBulk’u tagsAdd mutation metni ve key ile gönderin, ardından sonuç dosyasında satır bazında userErrors’ı kontrol edin.
Kod
tags-add.graphqlmutation TagOrder($id: ID!, $tags: [String!]!) {
tagsAdd(id: $id, tags: $tags) {
node {
id
}
userErrors {
field
message
}
}
}
tags-add.variables.json{
"id": "gid://shopify/Order/1234567890",
"tags": ["wholesale", "priority"]
}
tags-add.response.json{
"data": {
"tagsAdd": {
"node": {
"id": "gid://shopify/Order/1234567890"
},
"userErrors": []
}
}
}
tags.jsonl{"id":"gid://shopify/Order/1111111111","tags":["wholesale"]}
{"id":"gid://shopify/Order/1111111112","tags":["wholesale"]}
{"id":"gid://shopify/Order/1111111113","tags":["wholesale","priority"]}
bulk-operation-run-mutation.graphqlmutation TagOrdersInBulk($mutation: String!, $stagedUploadPath: String!) {
bulkOperationRunMutation(mutation: $mutation, stagedUploadPath: $stagedUploadPath) {
bulkOperation {
id
status
}
userErrors {
code
field
message
}
}
}
bulk-operation-run-mutation.variables.json{
"mutation": "mutation TagOrder($id: ID!, $tags: [String!]!) { tagsAdd(id: $id, tags: $tags) { node { id } userErrors { field message } } }",
"stagedUploadPath": "tmp/1234567890/bulk/00000000-0000-0000-0000-000000000000/tags.jsonl"
}
bulk-operation-run-mutation.response.json{
"data": {
"bulkOperationRunMutation": {
"bulkOperation": {
"id": "gid://shopify/BulkOperation/1234567892",
"status": "CREATED"
},
"userErrors": []
}
}
}
Lintel tarafından yazıldı. MIT lisansı: kendi mağazanızda da müşteri işlerinizde de ücretsiz kullanabilirsiniz.
Sınırlar ve özel durumlar
- tagsAdd yalnızca ekler; kayıttaki mevcut etiketler kalır. Etiketleri orderUpdate ya da productUpdate ile güncellemek ise listenin tamamını değiştirir.
- tags, bir liste ya da virgülle ayrılmış tek bir metin kabul eder.
- ID etiketlenemeyen bir tipe aitse mutation bulunamadı (not found) hatası döner.
- Toplu çalıştırmada her satır bir tagsAdd çağrısıdır; sonuç dosyası kayıt başına başarıyı ya da userErrors’ı gösterir.
Sık sorulan sorular
- Shopify’da siparişler toplu olarak nasıl etiketlenir?
- tagsAdd’i, sipariş ID’leri ve etiketlerden oluşan bir JSONL dosyasıyla bulkOperationRunMutation üzerinden çalıştırın. Birkaç yüz sipariş için tagsAdd’i döngüde çağırmak da yeterlidir.
- tagsAdd mevcut etiketleri siler mi?
- Hayır. Yalnızca gönderdiğiniz etiketleri ekler. Etiket kaldırmak için tagsRemove’u kullanın.
- tagsAdd ile hangi kayıtlar etiketlenebilir?
- Siparişler, taslak siparişler, müşteriler, ürünler ve blog yazıları ile referansta listelenen diğer kayıtlar.
Shopify belgeleri
- Gösterilen tarihte, 2026-10 sürümünün Admin veya Storefront API şemasıyla doğrulandı. İstek adresinizdeki sürümü kontrol edin.
- Örneklerdeki ID’ler ve mağaza adresleri yer tutucudur. Kendi değerlerinizle değiştirin.
- Admin API çağrıları uygulamanızdan bir erişim anahtarı (access token) ister. Admin API anahtarını asla vitrine ya da temaya koymayın.
- MIT lisansı. Kodu kendi mağazanızda da müşteri işlerinizde de kullanabilirsiniz.
Mağazanız için kurulmasını, test edilmesini ve bakımını isterseniz: API entegrasyonları.
