Yorumları ve yanıtları yönetme

Yorumlar, dosya hakkında kullanıcı tarafından sağlanan geri bildirimlerdir (örneğin, dosya okuyucusu, bir cümlenin farklı şekilde ifade edilmesini öneren kelime işlemci dokümanıdır. İki tür Yorum türleri: Sabit yorumlar ve Sabitlenmemiş yorumlar. Sabit bir yorum belirli bir konumla ilişkilidir (örneğin, kelime işleme dokümanı, dokümanın belirli bir sürümü içinde yer alır. Öte yandan sabitlenmemiş bir yorum yalnızca dokümanla ilişkilendirilir.

Yanıtlar yorumlara eklenir ve kullanıcının yorum'a dokunun. Drive API, kullanıcılarınızın Google Dokümanlar ve Google Dokümanlar. Yanıt içeren yorumlar toplu olarak şu şekilde adlandırılır: bir tartışma hazırlayın.

Bağlı olmayan yorum ekle

Sabitlenmemiş yorum eklemek için dokümana comments.create ve fileId parametresiyle Yorumu içeren comments kaynak.

Yorum düz metin olarak eklendi ancak yanıt gövdesi, Görüntülenecek şekilde biçimlendirilmiş içerik barındıran htmlContent alanı.

Yorumlara yanıt ekleme

Bir yoruma yanıt eklemek için şu numarayı arayın: replies.create yöntemini kullanıyorsanız fileId parametresi ve bir replies kaynağı emin olmanız gerekir.

Yanıt düz metin olarak eklenir ancak yanıt gövdesi, Görüntülenecek şekilde biçimlendirilmiş içerik barındıran htmlContent alanı.

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

Bir yorum eklediğinizde bunu dosyadaki bir bölgeye sabitlemek isteyebilirsiniz. anchor, yorumun bulunduğu dosyadaki dosya düzeltmesini ve bölgesini tanımlar ifade eder. comments kaynağı, anchor alanını içerir.

Sabit yorum eklemek için:

  1. (İsteğe bağlı). revisions.list numaralı telefonu arayın yöntemini kullanın.revisionID Bu adımı yalnızca aşağıdaki durumlarda uygulayın: yorumu, en son düzeltme dışındaki herhangi bir düzeltmeye sabitlemek istiyorsanız. En son düzeltmeyi kullanmak istiyorsanız revisionID için head kullanın.

  2. comments.create yöntemini çağırın fileID parametresiyle, bir comments yorumu içeren bir kaynak ve revisionID (r) ve bölge (a).

Bir bölgeyi nasıl tanımlayacağınız, çalıştığınız doküman içeriğinin türüne bağlıdır. ekleyebilirsiniz. Daha fazla bilgi için Bölge tanımlama bölümüne bakın.

Bölge tanımlayın

Daha önce belirtildiği gibi, JSON bağlantı dizesi bir revisionID (r) ve (a). Bölge (a), bölge sınıflandırıcıları içeren bir JSON dizisidir yorumun sabitlendiği biçimi ve konumu belirtme. Sınıflandırıcı bir resim için iki boyutlu bir dikdörtgen veya dokümandaki bir metin satırı olabilir. bir zaman dilimini kapsayabilir. Bölge tanımlamak için bölgeyi seçin sınıflandırıcıyı kullanın. Örneğin, Örneğin, içeriğiniz metinse büyük olasılıkla txt veya line bölge sınıflandırıcı.

Drive API'deki bölge sınıflandırıcılarının listesi için Bölge sınıflandırıcıları kullanın.

Aşağıdaki örnekte, yorumları satırlara sabitleyen bir JSON bağlantı dizesi gösterilmektedir iki ayrı alanda kullanılabilir:

  • İlk alan, 12. satırdan ('n':12) başlar ve üç satır boyunca sürer ('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 kimliği girin kabul edersiniz.

Yorumu sonlandırma

Şu ayarları yapmak için comment.update yöntemini kullanın: comments içindeki resolved mülkü bir yorum ele alındığında true adresine bir kaynak sunacaktır.

Uygulamanız resolved özelliğini true olarak ayarladığında kullanıcı arayüzünüz yoruma yanıt verildiğinden emin olun. Örneğin, uygulamanız:

  • Daha fazla yanıta izin verme ve önceki yanıtların tümünün yanı sıra orijinal yanıtın solukluğunu kapat yorum'a dokunun.
  • Sonlandırılan yorumları gizle.

Yorum silme

comments.delete yöntemini kullanarak yorumları silin. Bir yorum silindiğinde Drive, yorum kaynağını "deleted": "true" olarak belirleyin.

Yorumları listeleyin

Aşağıdakileri listelemek için comments.list yöntemini kullanın yorum. Silinen yorumları sonuçlara dahil etmek istiyorsanız includedDeleted alanını true değerine ayarlayın.