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
revisionID
listesini listelemek içinrevisions.list
yö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ızrevisionID
içinhead
politikasını kullanın.fileID
parametresi, yorumu içerencomments
kaynağı verevisionID
(r
) ile bölgeyi (a
) içeren JSON bağlantı dizesiylecomments.create
yö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.