Toplu Yükleme Kılavuzu

Büyük kataloglara sahip etiketler için toplu yükleme araçları önemli ölçüde zaman kazandırır. LabelGrid, birden çok sürüm yüklemek için iki yöntem destekler: API entegrasyonu ve DDEX içe aktarma.

Toplu Yükleme Yöntemleri

Mevcut Seçenekler

Yöntem	En Uygun Olduğu Durum	Gereken Plan
API entegrasyonu	Otomatik iş akışları, özel entegrasyonlar	API erişimi etkin planlar
DDEX içe aktarma	Sektör standardı beslemeler, büyük etiket iş akışları	Enterprise / API planları (destek ile iletişime geçin)

Not

Toplu yükleme yöntemleri, API erişimi etkin planlarda kullanılabilir. Planınız API erişimi içermiyorsa, LabelGrid panosu üzerinden sürümleri tek tek oluşturabilir veya API erişiminin etkinleştirilmesini görüşmek için destek ekibiyle iletişime geçebilirsiniz.

---

API Entegrasyonu

Genel Bakış

LabelGrid API’si, sürümleri programlı olarak oluşturup yönetmenize olanak tanır ve büyük kataloglar için tamamen otomatik iş akışları kurmanızı sağlar.

Neler Yapabilirsiniz

• Sürümleri programlı olarak oluşturma
• API üzerinden ses dosyaları yükleme
• Meta verileri toplu olarak yönetme
• Dağıtım iş akışlarını otomatikleştirme
• Mevcut sistemlerinizle entegrasyon kurma

Başlangıç

1. Planınızda API erişimini etkinleştirin – henüz etkin değilse destek ekibiyle iletişime geçin
2. Hesap ayarlarınızda API kimlik bilgileri oluşturun
3. Uç nokta ayrıntıları için API belgelerini inceleyin
4. Entegrasyonunuzu uygulayın veya SDK’larımızı kullanın
5. Canlı ortamdan önce hazırlık ortamında test edin

Örnek İstek

POST /api/public/releases
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "title": "Album Title",
  "type": "album",
  "primary_artist": "Artist Name",
  "release_date": "2024-03-15",
  "tracks": [
    {
      "title": "Track One",
      "track_number": 1,
      "isrc": "USRC12400001"
    }
  ]
}

Önceki Dağıtımcınızı Kaydetme

Başka bir platformda zaten yayında olan sürümleri taşırken, herkese açık Releases API’si, ayrıldığınız dağıtımcıyı kaydetmek için isteğe bağlı bir transfer_from_distributor alanı (serbest metin, en fazla 255 karakter) kabul eder. Bu alan, sürüm dağıtıldıktan sonra salt okunur hale gelir; bu nedenle gönderimden önce veya gönderim sırasında ayarlayın.

API’nin Avantajları

• Tam otomasyon – Hiçbir manuel müdahale gerekmez
• Sistem entegrasyonu – DAM, CRM veya diğer araçlarınızla bağlanın
• Zamanlanmış sürümler – Sürümleri gelecekteki dağıtım için kuyruğa alın
• Özel doğrulama – İçeriği gönderimden önce ön doğrulamadan geçirin
• Webhook bildirimleri – Teslimat durumu hakkında gerçek zamanlı güncellemeler alın
• Hata yönetimi – Programlı hata tespiti ve yeniden deneme

Hız Sınırları

API, sistem kararlılığını sağlamak için hız sınırlarına sahiptir. Güncel hız sınırı ayrıntıları için API Genel Bakış sayfasına bakın.

Eksiksiz belgeler için API Genel Bakış sayfasına bakın.

---

DDEX İçe Aktarma

Genel Bakış

DDEX (Digital Data Exchange), büyük etiketlerin içeriği dağıtımcılara teslim ederken kullandığı sektör standardı formattır. LabelGrid, halihazırda DDEX teslimat altyapısına sahip kurumsal müşteriler için DDEX içe aktarmayı destekler.

DDEX Nedir?

DDEX, şunları paketleyen XML tabanlı bir standarttır:

• Sürüm meta verileri
• Parça bilgileri
• Ses dosyası referansları
• Görseller ve diğer dosyalar
• Anlaşma şartları ve bölgeler

Desteklenen Formatlar

Sürüm	Durum
ERN 4.3.2	Destekleniyor (önerilen)
ERN 4.3.1	Destekleniyor
ERN 4.3.0	Destekleniyor
ERN 3.8.2	Destekleniyor (eski sürüm)

DDEX Kurulum Süreci

1. DDEX etkinleştirmesi talep etmek için destek ekibiyle iletişime geçin
2. Teknik ekibimizle kurulum sürecini tamamlayın
3. Teslimat ayarlarını ve dosya yollarını yapılandırın
4. Güvenli dosya aktarımı için SFTP kimlik bilgilerini ayarlayın
5. Doğrulama için test teslimatı gönderin
6. Onaylandıktan sonra canlı teslimatlara başlayın

Teslimat İş Akışı

Sisteminiz → DDEX XML + Dosyalar → SFTP Yükleme → LabelGrid İşleme → Dağıtım

DDEX Gereksinimleri

Gereksinim	Ayrıntılar
Plan	API erişimi etkin (destek ile iletişime geçin)
Format	ERN 4.3.2 tercih edilir (4.3.1, 4.3.0 ve 3.8.2 de desteklenir)
Teslimat	Yalnızca SFTP
Dosyalar	Ses dosyaları dahil edilmiş veya referans verilmiş
Doğrulama	Ön doğrulama önerilir

DDEX’i Ne Zaman Kullanmalı

DDEX içe aktarma şu durumlarda idealdir:

• Halihazırda DDEX teslimat altyapınız var
• DDEX kullanan başka bir dağıtımcıdan geçiş yapıyorsunuz
• İçerik yönetim sisteminiz DDEX’i kendiliğinden dışa aktarıyor
• Köklü iş akışlarına sahip büyük bir etiket veya büyük bir bağımsız yapımcısınız

API’yi Ne Zaman Tercih Etmeli

REST/JSON API şu durumlarda daha uygundur:

• Sıfırdan yeni bir entegrasyon kuruyorsunuz
• XML yerine modern web API’lerini tercih ediyorsunuz
• Gerçek zamanlı, çift yönlü iletişime ihtiyacınız var
• Webhook tabanlı bildirimler istiyorsunuz

---

Yönteminizi Seçme

Etken	API Entegrasyonu	DDEX İçe Aktarma
Kurulum karmaşıklığı	Daha düşük	Daha yüksek
Mevcut altyapı	Yeniden kurun	Mevcut DDEX’i kullanın
Format	JSON	XML
Teslimat yöntemi	HTTPS	SFTP
Gerçek zamanlı güncellemeler	Evet (webhook)	Yoklama gerekir
En uygun olduğu durum	Yeni entegrasyonlar	Kurumsal geçiş

---

İşleme Süreleri

İçerik API veya DDEX ile yüklendikten sonra işleme süresi şunlara bağlıdır:

• Sürüm ve parça sayısı
• Ses dosyası boyutları
• Meta veri karmaşıklığı
• Sistemin o anki yükü

Daha büyük katalogların işlenmesi doğal olarak daha uzun sürer. Kendi katalog büyüklüğünüze ilişkin tahmini sürelerde yönlendirmeye ihtiyacınız varsa destek ekibiyle iletişime geçin.

---

Büyük Geçişler İçin Gönderim Sınırları

Hesabınıza, son 7 günü kapsayan kayan bir sürüm gönderim sınırı uygulanabilir. Etkin olduğunda, hesabınızdaki her sürüm gönderimini sayar; bu, API ve DDEX içe aktarmalarıyla gönderilen sürümleri de kapsar ve bir sürümü yeniden göndermek de bu sayıya dahil olur.

Tek seferlik büyük bir katalog geçişi planlıyor ve bir hafta içinde 20’den fazla sürüm göndermeyi bekliyorsanız, bunu rehberli bir işlem olarak ele alın: planlamayı sizinle birlikte yapabilmemiz için önce destek ekibiyle iletişime geçin. Destek ekibi bir geçiş için geçici bir muafiyet penceresi ayarlayabilir; bu nedenle geçişin ortasında sınıra takılmak yerine yüklemeye başlamadan önce bize ulaşın.

Tüm parçaların aktarıldığını doğrulayın

Toplu veya DDEX içe aktarımının ardından, dağıtım yapmadan önce her parçanın doğru biçimde aktarıldığını teyit edin.

---

İlgili Konular

Büyük bir katalog mu yönetiyorsunuz? LabelGrid’in sürümlerinizi büyük ölçekte nasıl düzenli tuttuğunu öğrenmek için web sitemizdeki katalog yönetimi sayfasına bakın.

---

Yardıma mı İhtiyacınız Var?

Toplu yükleme kurulumu yardımı için:

• API entegrasyonu: API Genel Bakış sayfasına bakın veya destek ekibiyle iletişime geçin
• DDEX etkinleştirme: Gereksinimlerinizle birlikte destek ekibimizle iletişime geçin

Ekibimiz doğru yöntemi seçmenize yardımcı olabilir ve kurulum boyunca size rehberlik edebilir.