Alt kategorileri listeleme

Bir konumun faaliyet alanını sınıflandıran alt kategorilerin tam kataloğunu döndürür. Bu hesap yaklaşık 6.000 kayıt döndürür; bu nedenle kataloğu büyük ve çoğunlukla sabit bir başvuru kaynağı olarak ele alın, bir kez alın, önbelleğe kaydedin ve her oluşturma/güncelleme işlemi sırasında çağırmak yerine düzenli aralıklarla yenileyin.

Her öğe şunları içerir:

• databaseId: bir konum oluştururken veya güncellerken subCategoryId olarak iletilecek ve ek kategoriler için additionalCategoryIds dizisine dahil edilecek tam sayı.
• id: aynı kaydın Base64 ile kodlanmış Relay tanımlayıcısı.
• key: kategori adının URL uyumlu slug değeri.
• name: insanların okuyabileceği etiket.
• primary: kategorinin bir konumun birincil alt kategorisi olmaya uygun olup olmadığı.

Bir konum oluşturmadan önce kategoriyi belirleme

Bir konumu sisteme eklerken genellikle işletme türünü serbest metin olarak ("3D baskı hizmeti") bilirsiniz, ancak createLocation sayısal bir subCategoryId bekler. İzlenecek yöntem şudur: bu listeyi bir kez alın, kendi kodunuzda bir name → databaseId eşlemesi oluşturun, ardından oluşturma sırasında id değerini bu eşlemeden bulun.

const res = await fetch('https://listingsapi.com/api/v4/sub-categories', {  headers: { Authorization: 'API ' + process.env.LISTINGSAPI_KEY },});const { data } = await res.json();const byName = new Map(data.subcategories.map((s) => [s.name.toLowerCase(), s.databaseId])); const subCategoryId = byName.get('3d printing service'); // 4589

Bir konumu birden fazla kategoriyle etiketlemek için birincil kategoriyi subCategoryId alanında, en fazla 9 ek kategori id değerini ise additionalCategoryIds alanında iletin. Bu alanların nasıl kullanıldığı hakkında bilgi için Konum oluşturma ve Konum güncelleme bölümlerine bakın.

Yanıt, sayfalandırılmamış tek bir dizidir. Diğer tüm çağrılar gibi hesabınızın istek hızı sınırına dahil edilir; bu nedenle her konum için yeniden almak yerine önbelleğe kaydedin; 429 yanıtı bir Retry-After üst bilgisi içerir.