Toplu indirim kodu ekleme
discountRedeemCodeBulkAdd ile mevcut bir kodlu indirime çağrı başına 250’ye kadar benzersiz kod ekleyin, ardından hangi kodların eklendiğini kontrol edin.
- API
- Admin GraphQL API
- İşlemler
- discountRedeemCodeBulkAdd, discountRedeemCodeBulkCreation
- Erişim yetkisi
- write_discounts
- Yerini aldığı REST çağrısı
- POST /admin/api/price_rules/{id}/batch.json
- API sürümü
- 2026-10
- Son kontrol
Kısaca
Çok sayıda benzersiz indirim kodu oluşturmak için önce bir kodlu indirim oluşturun, ardından discountRedeemCodeBulkAdd’i onun DiscountCodeNode ID’si ve çağrı başına en fazla 250 kodla çağırın. Kodlar arka planda eklenir: done true olana kadar dönen ID ile discountRedeemCodeBulkCreation’ı sorgulayın, ardından importedCount, failedCount ve her kodun hatalarını (örneğin zaten var olan bir kod) okuyun.
Nasıl kullanılır
- İndirimi bir kez, admin’de ya da bir discountCode…Create mutation’ıyla oluşturun ve DiscountCodeNode ID’sini saklayın.
- Kodlarınızı üretin ve 250’şerlik parçalara bölün.
- Her parça için AddDiscountCodes’u gönderin ve her bulkCreation ID’sini saklayın.
- done true olana kadar DiscountCodeImport’u sorgulayın. Hata alan kodlar eklenmemiştir; yenileriyle değiştirip tekrar gönderin.
Kod
discount-redeem-code-bulk-add.graphqlmutation AddDiscountCodes($discountId: ID!, $codes: [DiscountRedeemCodeInput!]!) {
discountRedeemCodeBulkAdd(discountId: $discountId, codes: $codes) {
bulkCreation {
id
done
codesCount
importedCount
failedCount
}
userErrors {
code
field
message
}
}
}
discount-redeem-code-bulk-add.variables.json{
"discountId": "gid://shopify/DiscountCodeNode/1234567890",
"codes": [
{"code": "WELCOME-7KQ2"},
{"code": "WELCOME-M3XD"},
{"code": "WELCOME-P9TA"}
]
}
discount-redeem-code-bulk-add.response.json{
"data": {
"discountRedeemCodeBulkAdd": {
"bulkCreation": {
"id": "gid://shopify/DiscountRedeemCodeBulkCreation/1234567890",
"done": false,
"codesCount": 3,
"importedCount": 0,
"failedCount": 0
},
"userErrors": []
}
}
}
bulk-creation-status.graphqlquery DiscountCodeImport($id: ID!) {
discountRedeemCodeBulkCreation(id: $id) {
done
codesCount
importedCount
failedCount
codes(first: 250) {
nodes {
code
discountRedeemCode {
id
}
errors {
code
message
}
}
}
}
}
bulk-creation-status.variables.json{
"id": "gid://shopify/DiscountRedeemCodeBulkCreation/1234567890"
}
bulk-creation-status.response.json{
"data": {
"discountRedeemCodeBulkCreation": {
"done": true,
"codesCount": 3,
"importedCount": 2,
"failedCount": 1,
"codes": {
"nodes": [
{"code": "WELCOME-7KQ2", "discountRedeemCode": {"id": "gid://shopify/DiscountRedeemCode/1111111111"}, "errors": []},
{"code": "WELCOME-M3XD", "discountRedeemCode": {"id": "gid://shopify/DiscountRedeemCode/1111111112"}, "errors": []},
{"code": "WELCOME-P9TA", "discountRedeemCode": null, "errors": [{"code": "TAKEN", "message": "Code must be unique. Please try a different code."}]}
]
}
}
}
}
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
- Çağrı başına en fazla 250 kod. Tüm kodlar indirimin değerini, tarihlerini ve kullanım sınırlarını paylaşır.
- Kodlar mağaza genelinde benzersiz olmalıdır; tekrar eden bir kod tek başına başarısız olur, diğerlerini durdurmaz.
- Kodlar arka planda eklenir. Müşterilere göndermeden önce done’ın true olmasını bekleyin.
Sık sorulan sorular
- Shopify’da API ile benzersiz indirim kodları nasıl üretilir?
- Kodları kendi kodunuzda üretin, ardından discountRedeemCodeBulkAdd ile çağrı başına 250 kod olacak şekilde tek bir kodlu indirime ekleyin.
- Tek seferde kaç indirim kodu ekleyebilirim?
- discountRedeemCodeBulkAdd çağrısı başına en fazla 250. Daha büyük partiler için birden fazla çağrı yapın.
- Hangi kodların başarısız olduğunu nasıl anlarım?
- Dönen ID ile discountRedeemCodeBulkCreation’ı sorgulayın. failedCount toplamı verir; her kodun errors alanı nedenini açıklar.
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ı.
