Adapty Developer CLI için tam referans

Bir yapay zeka asistanı mı kullanıyorsunuz? LLM’lerin CLI ile çalışmasına yardımcı olmak için bir Adapty CLI becerisi mevcuttur.

Bu makalede tüm Adapty CLI komutları, argümanları, bayrakları ve kabul edilen değerleriyle birlikte listelenmiştir.

Kimlik doğrulama kurulumu ve token yönetimi için bkz. Kimlik doğrulama.

Global bayraklar

Bu bayraklar tüm komutlarda kullanılabilir.

Bayrak	Açıklama
`--json`	Biçimlendirilmiş metin yerine JSON olarak çıktı verir
`--help`	Komut yardımını gösterir

Tüm list komutları ayrıca sayfalama bayraklarını da kabul eder:

Bayrak	Varsayılan	Açıklama
`--page`	`1`	Sayfa numarası
`--page-size`	`20`	Sayfa başına öğe sayısı (maks: 100)

Uygulamalar

Adapty hesabınızdaki uygulamaları yönetin. Kontrol paneli tabanlı yapılandırma için bkz. Uygulama ayarları.

adapty apps list

Adapty hesabınızdaki tüm uygulamaları listeler.

adapty apps list

Sayfalama bayraklarını kabul eder.

adapty apps get

Belirli bir uygulama için ayrıntıları getirir.

adapty apps get <app-id>

Argüman	Açıklama
`app-id`	Uygulama ID’si (UUID)

adapty apps create

Yeni bir uygulama oluşturur.

adapty apps create --title "My App" --platform ios --apple-bundle-id com.example.app

Bayrak	Zorunlu	Açıklama
`--title`	Evet	Uygulama başlığı
`--platform`	Evet	Platform: `ios` veya `android`. İkisi için tekrarlayın: `--platform ios --platform android`
`--apple-bundle-id`	`--platform ios` ile zorunlu	Apple bundle ID
`--google-bundle-id`	`--platform android` ile zorunlu	Google bundle ID

adapty apps update

Mevcut bir uygulamayı günceller.

adapty apps update <app-id> --title "New Name"

Argüman	Açıklama
`app-id`	Uygulama ID’si (UUID)

Bayrak	Açıklama
`--title`	Yeni uygulama başlığı
`--apple-bundle-id`	Yeni Apple bundle ID
`--google-bundle-id`	Yeni Google bundle ID

En az bir bayrak zorunludur. --platform oluşturulduktan sonra değiştirilemez.

Access level’lar

adapty access-levels list

Bir uygulamadaki tüm access level’ları listeler.

adapty access-levels list --app <app-id>

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

Sayfalama bayraklarını kabul eder.

adapty access-levels get

Belirli bir access level için ayrıntıları getirir.

adapty access-levels get --app <app-id> <access-level-id>

Argüman	Açıklama
`access-level-id`	Access level ID’si (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

adapty access-levels create

Yeni bir access level oluşturur.

adapty access-levels create --app <app-id> --sdk-id "pro" --title "Pro"

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--sdk-id`	Evet	Uygulama kodunda erişimi kontrol etmek için kullanılan tanımlayıcı (örneğin, `"pro"` veya `"premium"`)
`--title`	Evet	Adapty kontrol panelinde görünen etiket

adapty access-levels update

Mevcut bir access level’ı günceller.

adapty access-levels update --app <app-id> <access-level-id> --title "Pro Access"

Argüman	Açıklama
`access-level-id`	Access level ID’si (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--title`	Evet	Yeni görünen etiket

--sdk-id oluşturulduktan sonra değiştirilemez.

Ürünler

adapty products list

Bir uygulamadaki tüm ürünleri listeler.

adapty products list --app <app-id>

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

Sayfalama bayraklarını kabul eder.

adapty products get

Belirli bir ürün için ayrıntıları getirir.

adapty products get --app <app-id> <product-id>

Argüman	Açıklama
`product-id`	Ürün ID’si (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

adapty products create

Yeni bir ürün oluşturur.

Mağaza ürün ID’leri (--ios-product-id, --android-product-id, --android-base-plan-id) oluşturulduktan sonra değiştirilemez. Farklı mağaza ürün ID’leri kullanmak için yeni bir ürün oluşturun.

adapty products create --app <app-id> --title "Monthly" --access-level-id <access-level-id> --period monthly --ios-product-id com.example.monthly

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--title`	Evet	Ürün başlığı
`--access-level-id`	Evet	Bu ürünün kilidi açacağı access level ID’si (UUID)
`--period`	Evet	Abonelik dönemi: `weekly`, `monthly`, `2_months`, `3_months`, `6_months`, `yearly`, `lifetime`
`--ios-product-id`	En az bir platform zorunlu	App Store Connect’teki ürün ID’si
`--android-product-id`	En az bir platform zorunlu	Google Play Console’daki ürün ID’si
`--android-base-plan-id`	`--period lifetime` olmadığı sürece `--android-product-id` ile zorunlu	Google Play Console’daki temel plan ID’si

adapty products update

Mevcut bir ürünü günceller.

Mağaza ürün ID’leri (--ios-product-id, --android-product-id) oluşturulduktan sonra değiştirilemez ve bu komutta kullanılamaz. Farklı mağaza ürün ID’leri kullanmak için yeni bir ürün oluşturun.

adapty products update --app <app-id> <product-id> --title "Monthly" --access-level-id <access-level-id>

Argüman	Açıklama
`product-id`	Ürün ID’si (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--title`	Hayır	Ürün başlığı
`--access-level-id`	Hayır	Bu ürünün kilidi açacağı access level ID’si (UUID)

Paywall’lar

adapty paywalls list

Bir uygulamadaki tüm paywall’ları listeler.

adapty paywalls list --app <app-id>

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

Sayfalama bayraklarını kabul eder.

adapty paywalls get

Belirli bir paywall için ayrıntıları getirir.

adapty paywalls get --app <app-id> <paywall-id>

Argüman	Açıklama
`paywall-id`	Paywall ID’si (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

adapty paywalls create

Yeni bir paywall oluşturur.

adapty paywalls create --app <app-id> --title "Default Paywall" --product-id <product-id>

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--title`	Evet	Paywall başlığı
`--product-id`	Evet	Ürün ID’si (UUID). Birden fazla ürün için tekrarlayın: `--product-id <id1> --product-id <id2>`

adapty paywalls update

Mevcut bir paywall’ın tüm alanlarını değiştirir.

Bir paywall placement’a bağlandıktan sonra ürünleri değiştirilemez. Yayındaki bir paywall’da farklı ürünler kullanmak için yeni bir paywall oluşturun ve placement’ı buna yönlendirmek üzere güncelleyin.

adapty paywalls update --app <app-id> <paywall-id> --title "Default Paywall" --product-id <product-id>

Bu komut, tam ürün listesi dahil tüm paywall alanlarını değiştirir.

Argüman	Açıklama
`paywall-id`	Paywall ID’si (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--title`	Evet	Paywall başlığı
`--product-id`	Evet	Ürün ID’si (UUID). Birden fazla ürün için tekrarlayın: `--product-id <id1> --product-id <id2>`

adapty paywalls placements

Belirli bir paywall’ın şu anda hangi placement’larda kullanıldığını listeler.

adapty paywalls placements --app <app-id> <paywall-id>

Argüman	Açıklama
`paywall-id`	Paywall ID’si (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

Bir paywall’ı değiştirmeden önce hangi placement’ların etkileneceğini görmek için bu komutu kullanın.

Placement’lar

adapty placements list

Bir uygulamadaki tüm placement’ları listeler.

adapty placements list --app <app-id>

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

Sayfalama bayraklarını kabul eder.

adapty placements get

Belirli bir placement için ayrıntıları alır.

adapty placements get --app <app-id> <placement-id>

Argüman	Açıklama
`placement-id`	Placement ID (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID (UUID)
Yanıt bir `audiences` dizisi içerir. Her giriş `{segment_ids, paywall_id, priority}` şeklindedir. Varsayılan kitle `segment_ids: []` değerine ve en yüksek öncelik değerine (en son değerlendirilen) sahiptir. Biçimlendirilmiş insan çıktısı, kolaylık sağlamak amacıyla varsayılan kitleden türetilen üst düzey bir `Paywall ID` de gösterir. `--json` seçeneği ham API şeklini değiştirmeden döndürür.

adapty placements create

Yeni bir placement oluşturur.

adapty placements create --app <app-id> --title "Main" --developer-id "main" --audiences '[{"segment_ids":[],"paywall_id":"<paywall-id>","priority":0}]'

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)
`--title`	Evet	Placement başlığı
`--developer-id`	Evet	Uygulamada bu placement’ı talep etmek için kullanılan string tanımlayıcı
`--audiences`	İkisinden biri	`{segment_ids, paywall_id, priority}` girişlerinden oluşan JSON dizisi. Bkz. Audiences şekli
`--paywall-id`	İkisinden biri	Kullanımdan kalkmış. Paywall ID’si (UUID). İstemci tarafında tek bir varsayılan kitleye sarılır

--audiences veya --paywall-id seçeneklerinden yalnızca birini girin. Her ikisini birden ya da hiçbirini geçmemek hata verir.

--paywall-id kullanımdan kaldırılmıştır ve ilerleyen sürümlerde kaldırılacaktır. Kullanıldığında, CLI stderr’e bir uyarı yazdırır ve değeri varsayılan bir kitleye dönüştürür. Yeni otomasyonlar için --audiences kullanın.

adapty placements update

Mevcut bir placement öğesinin tüm alanlarını değiştirir.

adapty placements update --app <app-id> <placement-id> --title "Main" --developer-id "main" --audiences '[{"segment_ids":[],"paywall_id":"<paywall-id>","priority":0}]'

Bu komut, tüm kitle listesi dahil olmak üzere placement’ın tüm alanlarını değiştirir.

Argüman	Açıklama
`placement-id`	Placement ID’si (UUID)
Bayrak	Zorunlu
---	---
`--app`	Evet
`--title`	Evet
`--developer-id`	Evet
`--audiences`	İkisinden biri
`--paywall-id`	İkisinden biri

--paywall-id parametresini geçmek, placement üzerindeki tüm kitlelerin üzerine yazar. Segmente özel kitleler silinir. Bunları korumak için --audiences kullanın ve saklamak istediğiniz tüm girişleri dahil edin.

Kitle yapısı

--audiences bayrağı bir JSON dizisi alır. Her giriş şunları içerir:

Alan	Tür	Açıklama
`segment_ids`	`string[]`	Bu kitle tarafından hedeflenen segment ID’leri. Uzunluk 0 veya 1. Boş dizi varsayılan kitleyi işaret eder — başka hiçbir segmentle eşleşmeyen kullanıcılar için yedek
`paywall_id`	`string`	Bu kitleye gösterilen paywall ID’si (UUID)
`priority`	`number`	0 tabanlı, placement içinde benzersiz. Kitleler düşükten yükseğe doğru değerlendirilir; varsayılan kitle en yüksek değere sahip olmalıdır

Bir placement’ın tam olarak bir varsayılan kitlesi olmalıdır.

Bir hedefli kitle ve bir varsayılan kitle içeren örnek:

adapty placements update <placement-id> --app <app-id> --title "Main" --developer-id "main" \
  --audiences '[{"segment_ids":["<vip-segment-id>"],"paywall_id":"<vip-paywall-id>","priority":0},{"segment_ids":[],"paywall_id":"<default-paywall-id>","priority":1}]'

Segment bazlı yönlendirmeyi kaybetmeden bir paywall’ı birden fazla placement’ta değiştirmek için:

Etkilenen placement’ları bulun:

adapty paywalls placements --app <app-id> <old-paywall-id>

Her biri için tam audiences dizisini okuyun:

adapty placements get --app <app-id> <placement-id> --json

Eşleşen paywall_id değerlerini istemci tarafında değiştirin.

Değiştirilmiş payload’ı geri yazın:

adapty placements update --app <app-id> <placement-id> --title "<title>" --developer-id "<developer-id>" --audiences '<modified-payload>'

Segmentler

Segmentler CLI üzerinden yalnızca okunabilir. Oluşturmak ve düzenlemek için Adapty Kontrol Paneli’ni kullanın. Placement kitlelerini oluştururken segment ID’lerini bulmak için bu komutları kullanın.

adapty segments list

Bir uygulama için tüm segmentleri listeler.

adapty segments list --app <app-id>

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID’si (UUID)

Sayfalandırma bayraklarını kabul eder.

adapty segments get

Belirli bir segment için ayrıntıları getirir.

adapty segments get --app <app-id> <segment-id>

Argüman	Açıklama
`segment-id`	Segment ID (UUID)

Bayrak	Zorunlu	Açıklama
`--app`	Evet	Uygulama ID (UUID)

Yanıt id, title ve description alanlarını içerir. Filtre kuralları bu API aracılığıyla gösterilmez.

Kimlik doğrulama

Komut	Açıklama
`adapty auth login`	Cihaz akışı ile tarayıcı üzerinden kimlik doğrulama yapar
`adapty auth logout`	Yerel olarak depolanan kimlik bilgilerini temizler
`adapty auth whoami`	Token’ı sunucu ile doğrular ve kullanıcı bilgilerini gösterir
`adapty auth status`	Sunucuya çağrı yapmadan yerel kimlik doğrulama durumunu gösterir
`adapty auth revoke`	Token’ı sunucu tarafında iptal eder ve yerel olarak temizler

Her komut hakkında ayrıntılı bilgi için bkz. Kimlik doğrulama.