Class ContactsApp

KişilerUygulaması

Kullanımdan kaldırıldı. Bunun yerine People API ileri seviye hizmetini kullanın.

Bu sınıf, kullanıcıların kendi Google Kişiler'ine erişmesine ve burada listelenen kişileri oluşturmasına, kaldırmasına ve güncellemesine olanak tanır.

Kullanımdan kaldırılan tesisler

Mülk	Tür	Açıklama
ExtendedField	ExtendedField
Field	Field
Gender	Gender
Month	Month
Priority	Priority
Sensitivity	Sensitivity

Kullanımdan kaldırılan yöntemler

Yöntem	Dönüş türü	Kısa açıklama
createContact(givenName, familyName, email)	Contact	Yeni bir kişi oluşturur.
createContactGroup(name)	ContactGroup	Belirtilen ada sahip bir kişi grubu oluşturur // The code below creates a new contact group named "Work Friends" const group = ContactsApp.createContactGroup('Work Friends');
deleteContact(contact)	void	Kişiyi siler.
deleteContactGroup(group)	void	Kişi grubunu siler. // The code below creates deletes the contact group named "Work Friends" const group = ContactsApp.getContactGroup('Work Friends'); ContactsApp.deleteContactGroup(group);
findByEmailAddress(email)	Contact	Belirtilen e-posta adresine sahip bir kişiyi bulur.
findContactGroup(name)	ContactGroup	Belirtilen ada sahip bir kişi grubunu bulur.
getAllContacts()	Contact[]	Bu kullanıcıya ait tüm kişileri alın.
getContact(emailAddress)	Contact	E-posta adresine göre bir kişiyi alır.
getContactById(id)	Contact	Bu kimliğe sahip kişiyi alır.
getContactGroup(name)	ContactGroup	Belirtilen ada sahip bir kişi grubunu alır veya böyle bir kişi grubu bulunamazsa null değerini döndürür.
getContactGroupById(id)	ContactGroup	Belirtilen kimliğe sahip bir kişi grubunu alır veya böyle bir kişi grubu bulunamazsa null değerini döndürür.
getContactGroups()	ContactGroup[]	Kullanıcının kişi gruplarının tam listesini alır.
getContacts()	Contact[]	Kullanıcının tüm kişilerini alır.
getContactsByAddress(query)	Contact[]	Bir adresle eşleşen kişileri alma
getContactsByAddress(query, label)	Contact[]	Belirli bir alanla sınırlı olarak, bir adresle eşleşen kişileri alın.
getContactsByAddress(query, label)	Contact[]	Belirtilen özel adres etiketiyle sınırlı olarak bir adresle eşleşen kişileri alın.
getContactsByCompany(query)	Contact[]	Şirket alanıyla eşleşen kişileri alın.
getContactsByCustomField(query, label)	Contact[]	Özel bir alandaki belirli bir değerle eşleşen kişileri alma
getContactsByDate(month, day, label)	Contact[]	Belirli bir standart alan için belirli bir ay ve günle eşleşen kişileri alın.
getContactsByDate(month, day, year, label)	Contact[]	Belirli bir standart alan için belirli bir ay, gün ve yılla eşleşen kişileri alın.
getContactsByDate(month, day, year, label)	Contact[]	Belirli bir özel alan için belirli bir ay, gün ve yılla eşleşen kişileri alın.
getContactsByDate(month, day, label)	Contact[]	Belirli bir özel alan için belirli bir ay ve günle eşleşen kişileri alın.
getContactsByEmailAddress(query)	Contact[]	Bir e-posta adresiyle eşleşen kişileri alma
getContactsByEmailAddress(query, label)	Contact[]	Belirli bir alanla sınırlı olarak, e-posta adresiyle eşleşen kişileri alın.
getContactsByEmailAddress(query, label)	Contact[]	Belirtilen özel e-posta adresi etiketiyle sınırlı olarak bir e-posta adresiyle eşleşen kişileri alın.
getContactsByGroup(group)	Contact[]	Belirli bir ContactGroup'daki kişileri alın.
getContactsByIM(query)	Contact[]	Anlık mesajlaşma adresiyle eşleşen kişileri alma
getContactsByIM(query, label)	Contact[]	Belirli bir alanla sınırlı olarak, anlık mesajlaşma adresiyle eşleşen kişileri alma
getContactsByIM(query, label)	Contact[]	Belirtilen özel anlık mesajlaşma etiketiyle sınırlı olarak, bir anlık mesajlaşma adresiyle eşleşen kişileri alın.
getContactsByJobTitle(query)	Contact[]	İş unvanı alanıyla eşleşen kişileri alın.
getContactsByName(query)	Contact[]	Bir adla eşleşen kişileri alın.
getContactsByName(query, label)	Contact[]	Belirli bir alanla sınırlı olarak, bir adla eşleşen kişileri alın.
getContactsByNotes(query)	Contact[]	Notlar alanıyla eşleşen kişileri alın.
getContactsByPhone(query)	Contact[]	Bir telefon numarasıyla eşleşen kişileri alın.
getContactsByPhone(query, label)	Contact[]	Belirli bir alanla sınırlı olarak, bir telefon numarasıyla eşleşen kişileri alın.
getContactsByPhone(query, label)	Contact[]	Belirtilen özel telefon numarası etiketiyle sınırlı olarak, bir telefon numarasıyla eşleşen kişileri alın.
getContactsByUrl(query)	Contact[]	Bir URL ile eşleşen kişileri alma
getContactsByUrl(query, label)	Contact[]	Belirli bir alanla sınırlı olarak, bir URL ile eşleşen kişileri alın.
getContactsByUrl(query, label)	Contact[]	Belirtilen özel URL etiketiyle sınırlı olarak bir URL ile eşleşen kişileri alma.

Kullanımdan kaldırılan yöntemler

createContact(givenName, familyName, email)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Yeni bir kişi oluşturur.

// The code below creates a new contact with the name "John Doe" and the email
// address "[e-mail]".
const contact = ContactsApp.createContact(
    'John',
    'Doe',
    '[e-mail]',
);

Parametreler

Ad	Tür	Açıklama
givenName	String	kişinin adı
familyName	String	kişinin soyadı
email	String	kişinin e-posta adresi

Return

Contact: Yeni oluşturulan Kişi nesnesi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• deleteContact(contact)

---

createContactGroup(name)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirtilen ada sahip bir kişi grubu oluşturur

// The code below creates a new contact group named "Work Friends"
const group = ContactsApp.createContactGroup('Work Friends');

Parametreler

Ad	Tür	Açıklama
name	String	yeni kişi grubunun adı

Return

ContactGroup: Yeni oluşturulan kişi grubu

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• deleteContactGroup(group)

---

deleteContact(contact)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Kişiyi siler.

// The code below retrieves a contact with the email address
// "[e-mail]" and then deletes that contact.
const contact = ContactsApp.getContact('[e-mail]');
ContactsApp.deleteContact(contact);

Parametreler

Ad	Tür	Açıklama
contact	Contact	silinecek kişi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• createContact(givenName, familyName, email)

---

deleteContactGroup(group)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Kişi grubunu siler.

// The code below creates deletes the contact group named "Work Friends"
const group = ContactsApp.getContactGroup('Work Friends');
ContactsApp.deleteContactGroup(group);

Parametreler

Ad	Tür	Açıklama
group	ContactGroup	Silmek istediğiniz kişi grubu

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• createContactGroup(name)

---

findByEmailAddress(email)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirtilen e-posta adresine sahip bir kişiyi bulur.

Parametreler

Ad	Tür	Açıklama
email	String	Bulunacak kişinin e-posta adresi

Return

Contact: Bu e-posta adresini içeren kişi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

---

findContactGroup(name)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirtilen ada sahip bir kişi grubunu bulur.

Parametreler

Ad	Tür	Açıklama
name	String	Bulunacak kişi grubunun adı

Return

ContactGroup: Belirtilen adla eşleşen kişi grubu

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

---

getAllContacts()

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Bu kullanıcıya ait tüm kişileri alın.

Return

Contact[]: Bu kullanıcının tüm kişileri

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

---

getContact(emailAddress)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

E-posta adresine göre bir kişiyi alır.

Birden fazla kişi aynı e-posta adresini paylaşıyorsa yöntem, e-posta adresini birincil olarak işaretleyen kişileri tercih eder. Hiçbir kişi e-posta adresini birincil olarak işaretlememişse veya birden fazla kişi e-posta adresini birincil olarak işaretlediyse yöntem, sıralanmış kişi listesinde ilk sonucu döndürür.

// The code below retrieves a contact with the email address
// "[e-mail]".
const contact = ContactsApp.getContact('[e-mail]');

Parametreler

Ad	Tür	Açıklama
emailAddress	String	kişinin e-posta adresi

Return

Contact: Bu e-posta adresini içeren kişi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContacts()
• getContactById(id)

---

getContactById(id)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Bu kimliğe sahip kişiyi alır.

// The code below retrieves the contact with the id
// "http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34ca5"
const id =
    'http://www.google.com/m8/feeds/contacts/john.doe%40example.com/base/7c86afde08d34c';
const contact = ContactsApp.getContactById(id);

Parametreler

Ad	Tür	Açıklama
id	String	Alınacak kişinin kimliği

Return

Contact: Eşleşen kişi veya null

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactGroup(name)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirtilen ada sahip bir kişi grubunu alır veya böyle bir kişi grubu bulunamazsa null değerini döndürür.

// The code below returns the contact group with the name "Work Friends"
const group = ContactsApp.getContactGroup('Work Friends');

Parametreler

Ad	Tür	Açıklama
name	String	Eşleştirilecek kişi grubunun adı

Return

ContactGroup: Eşleşen kişi grubu veya eşleşen kişi grubu bulunamazsa null

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContactGroups()

---

getContactGroupById(id)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirtilen kimliğe sahip bir kişi grubunu alır veya böyle bir kişi grubu bulunamazsa null değerini döndürür.

// The code below returns the contact group with the id
// "http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb"
const id =
    'http://www.google.com/m8/feeds/groups/john.doe%40example.com/base/54eefbb093fdecb';
const group = ContactsApp.getContactGroupById(id);

Parametreler

Ad	Tür	Açıklama
id	String	Eşleşecek kişi grubunun kimliği

Return

ContactGroup: Eşleşen kişi grubu veya eşleşen kişi grubu bulunamazsa null

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContactGroups()

---

getContactGroups()

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Kullanıcının kişi gruplarının tam listesini alır.

Kullanıcıların kişi listesi ve muhtemelen kişi grubu listesi olabilir. Her Kişi Grubu, Kişi içerebilir. Bu yöntem, tüm kişi gruplarının listesini döndürür.

// The retrieves all the contract groups for the user and then logs the group
// name of each contact group.
const groups = ContactsApp.getContactGroups();
for (let i = 0; i < groups.length; i++) {
  Logger.log(groups[i].getName());
}

Return

ContactGroup[]: Kullanıcının kişi gruplarının dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContactGroup(name)

---

getContacts()

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Kullanıcının tüm kişilerini alır.

// The code below will retrieve all the user's contacts
const contacts = ContactsApp.getContacts();

Return

Contact[]: Kullanıcının tüm kişilerini içeren bir dizi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByAddress(query)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Bir adresle eşleşen kişileri alma

// The code below returns an array of contacts where the contact's address
// contains "San Francisco'.
const contacts = ContactsApp.getContactsByAddress('San Francisco');

Parametreler

Ad	Tür	Açıklama
query	String	Kişinin adreslerinde aranacak dize

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByAddress(query, label)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirli bir alanla sınırlı olarak, bir adresle eşleşen kişileri alın.

// The code below returns an array of contacts where the contact's address
// contains "San Francisco" in the Home address field.
const contacts = ContactsApp.getContactsByAddress(
    'San Francisco',
    ContactsApp.Field.HOME_ADDRESS,
);

Parametreler

Ad	Tür	Açıklama
query	String	Kişinin adreslerinde aranacak dize
label	Field	İçinde arama yapılacak alan

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByAddress(query, label)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirtilen özel adres etiketiyle sınırlı olarak bir adresle eşleşen kişileri alın.

// The code below returns an array of contacts where the contact's address
// contains "San Francisco" in a custom address label (created by the user)
// called "vacation".
const contacts = ContactsApp.getContactsByAddress('San Francisco', 'vacation');

Parametreler

Ad	Tür	Açıklama
query	String	Kişinin adreslerinde, belirtilen özel adres etiketiyle aranacak dize
label	String	İçinde arama yapılacak özel adres etiketi

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByCompany(query)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Şirket alanıyla eşleşen kişileri alın.

// The code below returns an array of contacts where the contact's company field
// contains "Google".
const contacts = ContactsApp.getContactsByCompany('Google');

Parametreler

Ad	Tür	Açıklama
query	String	Kişinin şirket alanında aranacak dize

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByCustomField(query, label)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Özel bir alandaki belirli bir değerle eşleşen kişileri alma

Özel alan, bir dize veya ContactsApp.ExtendedField değerlerinden biri olarak belirtilebilir.

// The code below returns an array of contacts where the contact's custom field
// named "Favorite Sport" contains "tennis".
const contacts = ContactsApp.getContactsByCustomField(
    'tennis',
    'Favorite Sport',
);

Parametreler

Ad	Tür	Açıklama
query	Object	Kişinin özel alanında aranacak dize
label	ExtendedField	İçinde arama yapılacak özel alan

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByDate(month, day, label)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirli bir standart alan için belirli bir ay ve günle eşleşen kişileri alın.

// The code below returns an array of contacts where the contact's "Birthday"
// field contains April for the month and 19 for the day.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    ContactsApp.Field.BIRTHDAY,
);

Parametreler

Ad	Tür	Açıklama
month	Month	Eşlenecek ay (ContactsApp.Month öğesindeki değerlerden biri)
day	Integer	Eşleştirilecek gün
label	Field	ContactsApp.Field kaynağından, içinde arama yapılacak alan

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByDate(month, day, year, label)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirli bir standart alan için belirli bir ay, gün ve yılla eşleşen kişileri alın.

// The code below returns an array of contacts where the contact's "Birthday"
// field contains April for the month, 19 for the day, and 1950 for the year.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    1950,
    ContactsApp.Field.BIRTHDAY,
);

Parametreler

Ad	Tür	Açıklama
month	Month	Eşlenecek ay (ContactsApp.Month öğesindeki değerlerden biri)
day	Integer	Eşleştirilecek gün
year	Integer	Eşlenecek yıl (boş olabilir)
label	Field	ContactsApp.Field kaynağından, içinde arama yapılacak alan

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByDate(month, day, year, label)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirli bir özel alan için belirli bir ay, gün ve yılla eşleşen kişileri alın.

// The code below returns an array of contacts where the contact's custom "Start
// Date" field contains April for the month, 19 for the day, and 2011 for the
// year.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    2011,
    'Start Date',
);

Parametreler

Ad	Tür	Açıklama
month	Month	Eşlenecek ay (ContactsApp.Month öğesindeki değerlerden biri)
day	Integer	Eşleştirilecek gün
year	Integer	Eşleştirilecek yıl, boş olabilir
label	String	İçinde arama yapılacak özel alan

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByDate(month, day, label)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirli bir özel alan için belirli bir ay ve günle eşleşen kişileri alın.

// The code below returns an array of contacts where the contact's custom "Start
// Date" field contains April for the month and 19 for the day.
const contacts = ContactsApp.getContactsByDate(
    ContactsApp.Month.APRIL,
    19,
    'Start Date',
);

Parametreler

Ad	Tür	Açıklama
month	Month	Eşlenecek ay (ContactsApp.Month öğesindeki değerlerden biri)
day	Integer	Eşleştirilecek gün
label	String	İçinde arama yapılacak özel alan

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByEmailAddress(query)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Bir e-posta adresiyle eşleşen kişileri alma

// The code below returns an array of contacts where the contact's email address
// contains "[e-mail]'.
const contacts = ContactsApp.getContactsByEmailAddress('[e-mail]');

Parametreler

Ad	Tür	Açıklama
query	String	Kişi e-posta adreslerinde aranacak dize

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByEmailAddress(query, label)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirli bir alanla sınırlı olarak, e-posta adresiyle eşleşen kişileri alın.

// The code below returns an array of contacts where the contact's email address
// contains "[e-mail]" in the Home email field.
const contacts = ContactsApp.getContactsByEmailAddress(
    '[e-mail]',
    ContactsApp.Field.HOME_EMAIL,
);

Parametreler

Ad	Tür	Açıklama
query	String	Kişi e-posta adreslerinde aranacak dize
label	Field	İçinde arama yapılacak alan

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByEmailAddress(query, label)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirtilen özel e-posta adresi etiketiyle sınırlı olarak bir e-posta adresiyle eşleşen kişileri alın.

// The code below returns an array of contacts where the contact's email address
// contains "[e-mail]" in a custom email address label (created by
// the user) called "alternate".
const contacts = ContactsApp.getContactsByEmailAddress(
    '[e-mail]',
    'alternate',
);

Parametreler

Ad	Tür	Açıklama
query	String	Belirtilen özel e-posta adresi etiketine sahip iletişim e-posta adreslerinde aranacak dize
label	String	İçinde arama yapılacak özel e-posta adresi etiketi

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByGroup(group)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirli bir ContactGroup'daki kişileri alın.

// The code below returns an array of contacts in the ContactGroup with the name
// "Work Friends".
const group = ContactsApp.getContactGroup('Work Friends');
const contacts = ContactsApp.getContactsByGroup(group);

Parametreler

Ad	Tür	Açıklama
group	ContactGroup	kişi grubu

Return

Contact[]: Belirli gruptaki kişi dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByIM(query)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Anlık mesajlaşma adresiyle eşleşen kişileri alma

// The code below returns an array of contacts where the contact's instant
// messaging address contains "ChatWithJohnDoe" in any instant messaging field.
const contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe');

Parametreler

Ad	Tür	Açıklama
query	String	Kişinin anlık mesajlaşma adreslerinde aranacak dize

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByIM(query, label)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirli bir alanla sınırlı olarak, anlık mesajlaşma adresiyle eşleşen kişileri alma

// The code below returns an array of contacts where the contact's instant
// messaging address contains "ChatWithJohnDoe" in the AIM instant messaging
// field.
const contacts = ContactsApp.getContactsByIM(
    'ChatWithJohnDoe',
    ContactsApp.Field.AIM,
);

Parametreler

Ad	Tür	Açıklama
query	String	Kişinin anlık mesajlaşma adreslerinde aranacak dize
label	Field	İçinde arama yapılacak alan

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByIM(query, label)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirtilen özel anlık mesajlaşma etiketiyle sınırlı olarak, bir anlık mesajlaşma adresiyle eşleşen kişileri alın.

// The code below returns an array of contacts where the contact's instant
// messaging address contains "ChatWithJohnDoe" in a custom instant messaging
// label (created by the user) called "eBuddy".
const contacts = ContactsApp.getContactsByIM('ChatWithJohnDoe', 'eBuddy');

Parametreler

Ad	Tür	Açıklama
query	String	Kişinin anlık mesajlaşma adreslerinde, belirtilen özel anlık mesajlaşma etiketiyle aranacak dize
label	String	İçinde arama yapılacak özel anlık mesajlaşma etiketi

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByJobTitle(query)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

İş unvanı alanıyla eşleşen kişileri alın.

// The code below returns an array of contacts where the contact's job title
// field contains "Product Manager".
const contacts = ContactsApp.getContactsByJobTitle('Product Manager');

Parametreler

Ad	Tür	Açıklama
query	String	Kişinin iş unvanı alanında aranacak dize

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByName(query)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Bir adla eşleşen kişileri alın.

// The code below returns an array of contacts where the contact name contains
// "John"
const contacts = ContactsApp.getContactsByName('John');

Parametreler

Ad	Tür	Açıklama
query	String	kişi adlarında aranacak dize

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByName(query, label)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirli bir alanla sınırlı olarak, bir adla eşleşen kişileri alın.

// The code below returns an array of contacts where the contact name contains
// "John" in the Given Name field.
const contacts = ContactsApp.getContactsByName(
    'John',
    ContactsApp.Field.GIVEN_NAME,
);

Parametreler

Ad	Tür	Açıklama
query	String	kişi adlarında aranacak dize
label	Field	İçinde arama yapılacak alan

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByNotes(query)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Notlar alanıyla eşleşen kişileri alın.

// The code below returns an array of contacts where the contact's notes field
// contains "sent birthday card".
const contacts = ContactsApp.getContactsByNotes('sent birthday card');

Parametreler

Ad	Tür	Açıklama
query	String	kişinin notlar alanında aranacak dize

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByPhone(query)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Bir telefon numarasıyla eşleşen kişileri alın.

Bu yöntem, harf içeren telefon numaralarını genişletir. Dolayısıyla, "212-555-KODA" araması yaptığınızda kişileriniz arasında "212-555-2633" varsa veya tam tersi durumda bu yöntem uygun kişiyi bulur.

// The code below returns an array of contacts where the contact's phone number
// contains "212-555-1234' in any phone number field.
const contacts = ContactsApp.getContactsByPhone('212-555-1234');

Parametreler

Ad	Tür	Açıklama
query	String	Kişinin telefon numaralarında aranacak dize

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByPhone(query, label)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirli bir alanla sınırlı olarak, bir telefon numarasıyla eşleşen kişileri alın.

Bu yöntem, harf içeren telefon numaralarını genişletir. Dolayısıyla, "212-555-KODA" araması yaptığınızda ve kişileriniz arasında "212-555-2633" varsa veya tam tersi durumda bu yöntem uygun kişiyi bulur.

// The code below returns an array of contacts where the contact's phone number
// contains "212-555-1234" in the Home phone number field.
const contacts = ContactsApp.getContactsByPhone(
    '212-555-1234',
    ContactsApp.Field.HOME_PHONE,
);

Parametreler

Ad	Tür	Açıklama
query	String	Kişinin telefon numaralarında aranacak dize
label	Field	İçinde arama yapılacak alan

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByPhone(query, label)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirtilen özel telefon numarası etiketiyle sınırlı olarak, bir telefon numarasıyla eşleşen kişileri alın.

Bu yöntem, harf içeren telefon numaralarını genişletir. Dolayısıyla, "212-555-KODA" araması yaptığınızda kişileriniz arasında "212-555-2633" varsa veya tam tersi durumda bu yöntem uygun kişiyi bulur.

// The code below returns an array of contacts where the contact's phone number
// contains "212-555-1234" in a custom phone number label (created by the user)
// called "alternate".
const contacts = ContactsApp.getContactsByPhone('212-555-1234', 'alternate');

Parametreler

Ad	Tür	Açıklama
query	String	Kişilerin telefon numaralarında, belirtilen özel telefon numarası etiketiyle aranacak dize
label	String	Aramada kullanılacak özel telefon numarası etiketi

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByUrl(query)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Bir URL ile eşleşen kişileri alma

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com' in any URL field.
const contacts = ContactsApp.getContactsByUrl('www.example.com');

Parametreler

Ad	Tür	Açıklama
query	String	Kişinin URL'lerinde aranacak dize

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByUrl(query, label)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirli bir alanla sınırlı olarak, bir URL ile eşleşen kişileri alın.

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com" in the Work URL field.
const contacts = ContactsApp.getContactsByUrl(
    'www.example.com',
    ContactsApp.Field.WORK_WEBSITE,
);

Parametreler

Ad	Tür	Açıklama
query	String	Kişinin URL'lerinde aranacak dize
label	Field	İçinde arama yapılacak alan

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)

---

getContactsByUrl(query, label)

Kullanımdan kaldırıldı. Bu işlevin desteği sonlandırılmıştır ve yeni komut dosyalarında kullanılmamalıdır.

Belirtilen özel URL etiketiyle sınırlı olarak bir URL ile eşleşen kişileri alma.

// The code below returns an array of contacts where the contact's URL contains
// "www.example.com" in a custom URL label (created by the user) called
// "alternate work".
const contacts = ContactsApp.getContactsByUrl(
    'www.example.com',
    'alternate work',
);

Parametreler

Ad	Tür	Açıklama
query	String	Belirtilen özel URL etiketiyle iletişim kişisinin URL'lerinde aranacak dize
label	String	İçinde arama yapılacak özel URL etiketi

Return

Contact[]: Eşleşen kişiler dizisi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

• https://www.google.com/m8/feeds

Aşağıdaki kaynakları da incelemenizi öneririz:

• getContact(emailAddress)