Yorumlar, bir dosyayla ilgili kullanıcı tarafından sağlanan geri bildirimlerdir (örneğin, bir kelime işleme dokümanının bir okuyucusu, bir cümlenin nasıl yeniden ifade edileceğine dair öneride bulunabilir). İki tür yorum vardır: sabit yorumlar ve bağlanmamış yorumlar. Sabit bir yorum, bir dokümanın belirli bir sürümündeki belirli bir konumla (ör. kelime işleme dokümanındaki bir cümle) ilişkilendirilir. Öte yandan, bağlı olmayan yorum yalnızca dokümanla ilişkilendirilir.
Yanıtlar yorumlara eklenir ve kullanıcının yoruma verdiği yanıtı temsil eder. Drive API'si, kullanıcılarınızın uygulamanız tarafından oluşturulan dokümanlara yorum ve yanıt eklemesine olanak tanır. Yanıt içeren yorumlar, toplu olarak tartışma olarak adlandırılır.
Bağlı olmayan yorum ekle
Bir dokümana bağlı olmayan yorum eklemek için fileId parametresi ve yorumu içeren comments kaynağıyla comments.create yöntemini çağırın.
Yorum düz metin olarak eklenir, ancak yanıt gövdesi, görüntülenmek üzere biçimlendirilmiş içeriğin bulunduğu bir htmlContent alanı sağlar.
Yoruma yanıt ekleme
Bir yoruma yanıt eklemek için yorumla birlikte replies.create yöntemini, fileId parametresini ve yanıtı içeren replies kaynağını çağırın.
Yanıt düz metin olarak eklenir, ancak yanıt gövdesi, görüntülenmek üzere biçimlendirilmiş içeriğin bulunduğu bir htmlContent alanı sağlar.
Bir dokümanın en son düzeltmesine bağlı yorum ekleme
Bir yorum eklediğinizde, yorumu dosyadaki bir bölgeye bağlamak isteyebilirsiniz. Bağlayıcı, bir yorumun başvuruda bulunduğu dosyadaki dosya düzeltmesini ve bölgeyi tanımlar. comments kaynağı, anchor alanını bir JSON dizesi olarak tanımlar.
Sabit yorum eklemek için:
(İsteğe bağlı). Bir belgedeki her
revisionIDlistesini listelemek içinrevisions.listyöntemini çağırın. Bu adımı yalnızca bir yorumu, en son düzeltme dışındaki bir düzeltmeye bağlamak istiyorsanız uygulayın. En son düzeltmeyi kullanmak istiyorsanızrevisionIDiçinheadpolitikasını kullanın.fileIDparametresi, yorumu içerencommentskaynağı verevisionID(r) ile bölgeyi (a) içeren JSON bağlantı dizesiylecomments.createyöntemini çağırın.
Bir bölgeyi nasıl tanımlayacağınız, üzerinde çalıştığınız doküman içeriğinin türüne bağlıdır. Daha fazla bilgi için Bölge tanımlama konusuna bakın.
Bölge tanımlayın
Daha önce belirtildiği gibi, JSON bağlantı dizesi bir revisionID (r) ve bölge (a) içerir. Bölge (a), yorumun bağlı olduğu biçimi ve konumu belirten bölge sınıflandırıcıları içeren bir JSON dizisidir. Sınıflandırıcı, bir resim için iki boyutlu bir dikdörtgen, bir dokümandaki metin satırı veya bir videodaki bir süre süresi olabilir. Bir bölge tanımlamak için, sabitlemeye çalıştığınız içeriğin türüyle eşleşen bölge sınıflandırıcısını seçin. Örneğin, içeriğiniz metinse muhtemelen txt veya line bölge sınıflandırıcısını kullanırsınız.
Drive API'deki bölge sınıflandırıcılarının listesi için Bölge sınıflandırıcıları konusuna bakın.
Aşağıdaki örnekte, yorumları bir dokümanın iki ayrı alanındaki satırlara bağlayan bir JSON bağlantı dizesi gösterilmektedir:
- İlk alan, 12. satırdan (
'n':12) başlar ve üç satıra ('l':3) kadar uzanır. - İkinci alan yalnızca 18. satırı kapsıyor (
'n':18, 'l':1`).
{
'r': 'REVISION_ID',
'a': [
{
'line':
{
'n': 12,
'l': 3,
}
},
{
'line':
{
'n': 18,
'l': 1,
}
}]
}
REVISION_ID değerini head veya belirli bir düzeltmenin kimliğiyle değiştirin.
Bir yorumu çözüme kavuşturma
Bir yorum yapıldığında, comments kaynağındaki resolved özelliğini true olarak ayarlamak için comment.update yöntemini kullanın.
Uygulamanız resolved özelliğini true olarak ayarladığında, kullanıcı arayüzünüz yorumun ele alındığını belirtmelidir. Örneğin, uygulamanız:
- Diğer yanıtlara izin verme ve önceki tüm yanıtlar ile orijinal yorumu karartma.
- Sonlandırılan yorumları gizle'ye dokunun.
Yorum silme
Yorumları silmek için comments.delete yöntemini kullanın. Bir yorum silindiğinde Drive, yorum kaynağını "deleted": "true" olarak işaretler.
Yorumları listeleme
Yorumları listelemek için comments.list yöntemini kullanın. Sonuçlara silinen yorumları dahil etmek istiyorsanız includedDeleted alanını true olarak ayarlayın.