Yorumlar, dosya hakkında kullanıcı tarafından sağlanan geri bildirimlerdir. Örneğin, 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ölgeyi tanımlar
ifade eder. comments
kaynağı,
anchor
alanını içerir.
Sabit yorum eklemek için:
(İ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ızrevisionID
içinhead
kullanın.comments.create
yöntemini çağırınfileID
parametresiyle, bircomments
yorumu içeren bir kaynak verevisionID
(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 tüm yanıtlar ile 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.