Yorumları ve yanıtları yönetme

Yorumlar, bir dosyayla ilgili kullanıcı tarafından sağlanan geri bildirimlerdir (ör. bir kelime işlemci belgesinin okuyucusu, bir cümlenin nasıl yeniden ifade edileceğini önerir). İki tür yorum vardır: sabitlenmiş yorumlar ve sabitlenmemiş yorumlar. Sabitlenmiş yorumlar, bir dokümanın belirli bir sürümünde belirli bir konumla (ör. bir kelime işlemci dokümanında bir cümle) ilişkilendirilir. Buna karşılık, sabitlenmemiş bir 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, 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 tartışma olarak adlandırılır.

Yerleşimsiz yorum ekleme

Bir dokümana sabitlenmemiş bir yorum eklemek için fileId parametresi ve yorumu içeren bir comments kaynağıyla comments.create yöntemini çağırın.

Yorum düz metin olarak eklenir ancak yanıt gövdesinde, görüntüleme için biçimlendirilmiş içerik içeren bir htmlContent alanı sağlanır.

Yorumlara yanıt ekleme

Bir yoruma yanıt eklemek için yorumu, fileId parametresini ve yanıtı içeren bir replies kaynağıyla replies.create yöntemini çağırın.

Yanıt düz metin olarak eklenir ancak yanıt gövdesinde, görüntüleme için biçimlendirilmiş içerik içeren bir htmlContent alanı bulunur.

Bir dokümanın en son düzeltmesine sabitlenmiş yorum ekleme

Eklediğiniz yorumları dosyanın bir bölgesine sabitlemek isteyebilirsiniz. Yan referans, bir yorumun referans verdiği dosyadaki dosya düzeltmesini ve bölgeyi tanımlar. comments kaynağı, anchor alanını JSON dizesi olarak tanımlar.

Sabitlenmiş yorum eklemek için:

  1. (İsteğe bağlı). Bir dokümanla ilgili tüm revisionID öğelerini listelemek için revisions.list yöntemini çağırın. Bu adımı yalnızca bir yorumu en son düzeltme dışındaki bir düzeltmeye sabitlemek istiyorsanız uygulayın. En son düzeltmeyi kullanmak istiyorsanız revisionID için head değerini kullanın.

  2. fileID parametresi, yorumu içeren bir comments kaynağı ve revisionID (r) ile bölgeyi (a) içeren bir JSON ankraj dizesi ile comments.create yöntemini çağırın.

Bir bölgeyi nasıl tanımladığı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 başlıklı makaleyi inceleyin.

Bölge tanımlama

Daha önce de belirtildiği gibi, JSON ankraj dizesi bir revisionID (r) ve bölge (a) içerir. Bölge (a), bir yorumun sabitlendiği 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 belgedeki metin satırı veya bir videodaki süre olabilir. Bir bölge tanımlamak için, sabitlemek istediğiniz içerik türüyle eşleşen bölge sınıflandırıcıyı seçin. Örneğin, içeriğiniz metinse muhtemelen txt veya line bölge sınıflandırıcısını kullanacaksı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ı başlıklı makaleyi inceleyin.

Aşağıdaki örnekte, yorumları bir belgenin iki ayrı alanındaki satırlara sabitleyen bir JSON ankraj dizesi gösterilmektedir:

  • İlk alan 12. satırdan ('n':12) başlar ve üç satır boyunca devam eder ('l':3).
  • İkinci alan yalnızca 18. satırı ('n':18, 'l':1`) kapsar.
    {
      'r': 'REVISION_ID',
      'a': [
      {
        'line':
        {
          'n': 12,
          'l': 3,
        }
      },
      {
        'line':
        {
          'n': 18,
          'l': 1,
        }
      }]
    }

REVISION_ID yerine head veya belirli bir düzeltmenin kimliğini yazın.

Yorumu çözüldü olarak işaretleme

Bir yorum ele alındığında comments kaynağındaki resolved özelliğini true olarak ayarlamak için comment.update yöntemini kullanın.

Uygulamanız resolved mülkünü true olarak ayarladığında kullanıcı arayüzünüzde yorumun ele alındığı belirtilir. Örneğin, uygulamanız:

  • Başka yanıtlara izin vermez ve önceki tüm yanıtların yanı sıra orijinal yorumu karartır.
  • Sonlandırılan yorumları gizle'yi tıklayın.

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. Silinen yorumları sonuçlara dahil etmek istiyorsanız includedDeleted alanını true olarak ayarlayın.