Formlar
Kayıt formları, onları dolduran kişiler ve rakamları.
Form araçları
| Araç | Ne yapar |
|---|---|
| listForms | Çalışma alanının kayıt formları, en son değiştirilen önce; durumları, kayıtları ve görüntülemeleriyle. |
| getForm | Bir formun tamamı: alanları, metinleri, kitleleri, çift onayı ve bildirimleri. Yayımlanmış bir formda bunlara bağlantısı, yerleştirme kodu ve düz bir HTML formunun veri gönderdiği adres de eklenir; includeDesign ise taslağı JSON olarak döndürür. |
| listFormStarters | Yeni bir formun başlayabileceği başlangıç noktaları ve her birinin istediği alanlar. |
| createForm | Bir başlangıç noktasından, document olarak yazılmış bir tasarımdan ya da üzerine değişiklikler eklenmiş bir başlangıç noktasından, istediğiniz ayarlarla bir form oluşturun. publish true olmadıkça taslak olarak kalır. |
| updateForm | Bir formun hemen uygulanan adını ve ayarlarını ya da document aracılığıyla taslak tasarımını değiştirin. Metinler ve biçim anahtar anahtar birleştirilir; fields ise listenin tamamını değiştirir. |
| publishForm | Mevcut taslağı ziyaretçilerin gördüğü sürüm yapın; böylece form kayıt alır. |
| setFormStatus | Yayımlanmış bir formu duraklatın ya da yeniden açın. |
| duplicateForm | Bir formu, kayıtları olmadan yeni bir taslağa kopyalayın. |
| deleteForm | Bir formu ve kayıtlarını kalıcı olarak silin. Bağlantısı ve yerleştirmeleri çalışmayı bırakır; eklediği kişiler ise kişilerinizde kalır. |
| getFormAnalytics | Bir zaman aralığında görüntülemeler, kayıtlar, eklenen ve hâlâ bekleyen kişiler ve dönüşüm oranı; toplamda ve dakika, saat ya da gün başına. Görüntülemeler saatlik olarak tutulur. |
| listFormSubmissions | Bir formu dolduran kişiler, en yeniden eskiye, yanıtları ve durumlarıyla, her seferinde bir sayfa. E-posta adresine göre arayın ve duruma göre filtreleyin. |
| getFormSubmission | Bir kaydın tamamı: her yanıt, durumu, ne zaman geldiği ve kişinin ne zaman eklendiği, geldiği sayfa ve kitleleri. |
| approveFormSubmission | Onayını bekleyen bir kaydı onay e-postası olmadan ekleyin. Ayrıca contacts:write gerektirir. |
| resendFormConfirmation | Hâlâ bekleyen bir kayda yeni bir onay bağlantısını e-postayla gönderin. Bu form son on dakikada o adrese e-posta gönderdiyse ya da adres son bir günde bu çalışma alanından beş onay aldıysa hiçbir şey gönderilmez. Ayrıca emails:send gerektirir. |
| removeFormSubmissions | Bir formun en fazla 200 kaydını id ile silin. Kişiler ve kitleler olduğu gibi kalır. |
Okumak forms:read, her değişiklik ise forms:write gerektirir. Bir formun posta göndermesine yol açan her şey ayrıca emails:send gerektirir: çift onayı açmak, göndereni ya da onay e-postasını ayarlamak, çift onaylı bir formu yayımlamak ya da yeniden açmak ve bir onayı yeniden göndermek. Bir üye adına çalışan bir istemci yalnızca o üyenin oluşturduğu formları görür; bazı adreslerle sınırlı bir istemci ise onayları yalnızca erişebildiği adreslerden gönderebilir ve yalnızca bu adresleri bilgilendirebilir.
Yazılı bir tariften form tasarlamak uygulamanın sohbetinde yapılır. MCP üzerinden tasarımcı istemcinin kendisidir: alanları, metinleri ve biçimi document olarak createForm ya da updateForm aracına geçirin; araçlar tasarımı toparlar ve neyi değiştirdiklerini söyler.
Bu sunucudaki yedi araç, REST API'nin bir doğrulama koduyla koruduğu bir değişiklik yapar ve aynı kodu ister: createRule, setRuleEnabled, removeDomain, removeDomainAddress, removeAppHost, deleteForm ve oluşturduğunuz bir kitlede deleteAudience. İstemci son 60 dakikada bir kod doğrulamadıkça ya da kişi Hesap → Bağlı uygulamalar'da onun için 60 dakika boyunca değişikliklere izin ver'i seçmedikçe böyle bir araç Refused (step_up_required): ile başlayan bir sonuçla yanıt verir ve hiçbir şeyi değiştirmez. emptyAudience hiçbir zaman kod istemez. API'nin Kimlik doğrulama sayfası bir kodun nasıl isteneceğini ve doğrulanacağını gösterir.
Araçlar REST API ile aynı kuralları ve retleri uygular ve API başvurusunun /forms sayfaları her alanı açıklar. listForms son değişikliğe göre sıralar; createForm ve updateForm kısmi bir document değerini toparlar, API ise onu bütün olarak alır.
