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 sohbet 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ı sağlanır.

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

Eklediğiniz yorumları dosyanın bir bölgesine sabitlemek isteyebilirsiniz. Bağlayıcı, bir yorumun atıfta bulunduğu 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 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 belirtildiği gibi, JSON bağlantı dizesi revisionID (r) ve bölge (a) içerir. Bölge (a), bir 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 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ısını 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 ('l':3) boyunca uzanır.
  • İ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 sonlandırma

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 özelliğini true olarak ayarladığında, kullanıcı arayüzünüz yorumun ele alındığını belirtmelidir. Örneğin, uygulamanız:

  • Bundan sonraki yanıtlara izin vermeme ve önceki tüm yanıtlarla birlikte orijinal yorumu gizleme.
  • 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ı listeleyin

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.