Class ContactsApp

KontaktyAplikacja

Wycofany. Zamiast tego użyj zaawansowanego interfejsu People API.

Ta klasa umożliwia użytkownikom dostęp do ich własnych kontaktów w Google oraz tworzenie, usuwanie i aktualizowanie kontaktów na tej liście.

WłaściwośćTypOpis
ExtendedFieldExtendedField
FieldField
GenderGender
MonthMonth
PriorityPriority
SensitivitySensitivity
MetodaZwracany typKrótki opis
createContact(givenName, familyName, email)ContactTworzy nowego kontaktu.
createContactGroup(name)ContactGroupTworzy grupę kontaktów o podanej nazwie.
// The code below creates a new contact group named "Work Friends"
const group = ContactsApp.createContactGroup('Work Friends');
deleteContact(contact)voidUsuwanie kontaktu.
deleteContactGroup(group)voidusuwa grupę kontaktów;
// The code below creates deletes the contact group named "Work Friends"
const group = ContactsApp.getContactGroup('Work Friends');
ContactsApp.deleteContactGroup(group);
findByEmailAddress(email)ContactZnajduje kontakt o podanym adresie e-mail.
findContactGroup(name)ContactGroupZnajduje grupę kontaktów o podanej nazwie.
getAllContacts()Contact[]Pobieranie wszystkich kontaktów należących do tego użytkownika.
getContact(emailAddress)ContactPobiera kontakt o danym adresie e-mail.
getContactById(id)ContactPobiera kontakt o tym identyfikatorze.
getContactGroup(name)ContactGroupPobiera grupę kontaktów o danej nazwie lub zwraca wartość null, jeśli nie można znaleźć takiej grupy.
getContactGroupById(id)ContactGroupPobiera grupę kontaktów o danym identyfikatorze lub zwraca wartość null, jeśli nie można znaleźć takiej grupy.
getContactGroups()ContactGroup[]Pobiera pełną listę grup kontaktów użytkownika.
getContacts()Contact[]Pobiera wszystkie kontakty użytkownika.
getContactsByAddress(query)Contact[]Pobieranie kontaktów pasujących do adresu.
getContactsByAddress(query, label)Contact[]Pobieranie kontaktów pasujących do adresu, ograniczone do określonego pola.
getContactsByAddress(query, label)Contact[]Pobieranie kontaktów pasujących do adresu, ograniczone do określonej etykiety adresu niestandardowego.
getContactsByCompany(query)Contact[]Pobierz kontakty pasujące do pola firmy.
getContactsByCustomField(query, label)Contact[]Pobieranie kontaktów pasujących do określonej wartości w polu niestandardowym.
getContactsByDate(month, day, label)Contact[]Pobiera kontakty pasujące do danego miesiąca i dnia w przypadku konkretnego pola standardowego.
getContactsByDate(month, day, year, label)Contact[]Pobiera kontakty pasujące do danego miesiąca, dnia i roku w przypadku konkretnego pola standardowego.
getContactsByDate(month, day, year, label)Contact[]Pobiera kontakty, które w danym polu niestandardowym pasują do podanego miesiąca, dnia i roku.
getContactsByDate(month, day, label)Contact[]Pobiera kontakty, które w danym polu niestandardowym odpowiadają podanemu miesiącowi i dniu.
getContactsByEmailAddress(query)Contact[]Pobieranie kontaktów pasujących do adresu e-mail.
getContactsByEmailAddress(query, label)Contact[]Pobieranie kontaktów pasujących do adresu e-mail, ograniczone do określonego pola.
getContactsByEmailAddress(query, label)Contact[]Pobieranie kontaktów pasujących do adresu e-mail, ograniczone do określonej etykiety niestandardowego adresu e-mail.
getContactsByGroup(group)Contact[]Pobieranie kontaktów z danej grupy kontaktów.
getContactsByIM(query)Contact[]Pobieranie kontaktów pasujących do adresu czatu.
getContactsByIM(query, label)Contact[]Pobieranie kontaktów pasujących do adresu czatu, ograniczone do określonego pola.
getContactsByIM(query, label)Contact[]Pobieranie kontaktów pasujących do adresu czatu ograniczone do określonej niestandardowej etykiety czatu.
getContactsByJobTitle(query)Contact[]Pobieranie kontaktów pasujących do pola „Stanowisko”.
getContactsByName(query)Contact[]Pobieranie kontaktów pasujących do nazwy.
getContactsByName(query, label)Contact[]Pobieranie kontaktów pasujących do nazwy, ograniczone do określonego pola.
getContactsByNotes(query)Contact[]Pobierz kontakty pasujące do pola notatek.
getContactsByPhone(query)Contact[]Pobieranie kontaktów pasujących do numeru telefonu.
getContactsByPhone(query, label)Contact[]Pobieranie kontaktów pasujących do numeru telefonu, ograniczone do konkretnego pola.
getContactsByPhone(query, label)Contact[]Pobieranie kontaktów pasujących do numeru telefonu, ograniczone do określonej niestandardowej etykiety numeru telefonu.
getContactsByUrl(query)Contact[]Pobieranie kontaktów pasujących do adresu URL.
getContactsByUrl(query, label)Contact[]Pobieranie kontaktów pasujących do adresu URL, ograniczone do konkretnego pola.
getContactsByUrl(query, label)Contact[]Pobieranie kontaktów pasujących do adresu URL, ograniczone do określonej etykiety niestandardowego adresu URL.

Wycofane metody

Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Tworzy nowego kontaktu.

// The code below creates a new contact with the name "John Doe" and the email
// address "john.doe@example.com".
const contact = ContactsApp.createContact(
    'John',
    'Doe',
    'john.doe@example.com',
);

Parametry

NazwaTypOpis
givenNameStringimię kontaktu
familyNameStringnazwisko kontaktu.
emailStringadres e-mail kontaktu.

Powrót

Contact – nowo utworzony obiekt Contact

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Tworzy grupę kontaktów o podanej nazwie.

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

Parametry

NazwaTypOpis
nameStringnazwę nowej grupy kontaktów.

Powrót

ContactGroup – nowo utworzona grupa kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Usuwanie kontaktu.

// The code below retrieves a contact with the email address
// "john.doe@example.com" and then deletes that contact.
const contact = ContactsApp.getContact('john.doe@example.com');
ContactsApp.deleteContact(contact);

Parametry

NazwaTypOpis
contactContactkontakt, który ma zostać usunięty;

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

usuwa grupę kontaktów;

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

Parametry

NazwaTypOpis
groupContactGroupgrupę kontaktów, którą chcesz usunąć.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Znajduje kontakt o podanym adresie e-mail.

Parametry

NazwaTypOpis
emailStringadres e-mail kontaktu, którego chcesz znaleźć;

Powrót

Contact – kontakt zawierający ten adres e-mail.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Znajduje grupę kontaktów o podanej nazwie.

Parametry

NazwaTypOpis
nameStringnazwę grupy kontaktów, którą chcesz znaleźć.

Powrót

ContactGroup – grupa kontaktów pasująca do podanego imienia

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie wszystkich kontaktów należących do tego użytkownika.

Powrót

Contact[] – wszystkie kontakty tego użytkownika

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobiera kontakt według adresu e-mail.

Jeśli kilka kontaktów ma ten sam adres e-mail, metoda preferuje te kontakty, w których przypadku adres e-mail został oznaczony jako podstawowy. Jeśli żaden z kontaktów nie ma adresu e-mail oznaczonego jako podstawowy lub jeśli adres e-mail jest oznaczony jako podstawowy w przypadku kilku kontaktów, zwracany jest pierwszy wynik w kolejności sortowania kontaktów.

// The code below retrieves a contact with the email address
// "john.doe@example.com".
const contact = ContactsApp.getContact('john.doe@example.com');

Parametry

NazwaTypOpis
emailAddressStringadres e-mail kontaktu.

Powrót

Contact – kontakt zawierający ten adres e-mail.

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobiera kontakt o tym identyfikatorze.

// 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);

Parametry

NazwaTypOpis
idStringidentyfikator kontaktu do pobrania;

Powrót

Contact – pasujący kontakt lub wartość null,

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobiera grupę kontaktów o danej nazwie lub zwraca wartość null, jeśli nie można znaleźć takiej grupy.

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

Parametry

NazwaTypOpis
nameStringnazwę grupy kontaktów do dopasowania;

Powrót

ContactGroup – pasująca grupa kontaktów lub null, jeśli nie znaleziono pasującej grupy kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobiera grupę kontaktów o danym identyfikatorze lub zwraca wartość null, jeśli nie można znaleźć takiej grupy.

// 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);

Parametry

NazwaTypOpis
idStringidentyfikator grupy kontaktów do dopasowania

Powrót

ContactGroup – pasująca grupa kontaktów lub null, jeśli nie znaleziono pasującej grupy kontaktów

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobiera pełną listę grup kontaktów użytkownika.

Użytkownik może mieć listę kontaktów, a potencjalnie także listę grup kontaktów. Każda grupa kontaktów może zawierać kontakty. Ta metoda zwraca listę wszystkich grup kontaktów.

// 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());
}

Powrót

ContactGroup[] – tablica grup kontaktów użytkownika

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobiera wszystkie kontakty użytkownika.

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

Powrót

Contact[] – tablica wszystkich kontaktów użytkownika

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do adresu.

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

Parametry

NazwaTypOpis
queryStringciąg tekstowy do wyszukania w adresach kontaktów

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do adresu, ograniczone do określonego pola.

// 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,
);

Parametry

NazwaTypOpis
queryStringciąg tekstowy do wyszukania w adresach kontaktów
labelFieldpole, w którym ma być przeprowadzone wyszukiwanie;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do adresu, ograniczone do określonej etykiety adresu niestandardowego.

// 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');

Parametry

NazwaTypOpis
queryStringciąg znaków do wyszukania w adresach kontaktów z wybranym adresem niestandardowym etykieta
labelStringetykiety adresu własnego, w której chcesz przeprowadzić wyszukiwanie;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobierz kontakty pasujące do pola firmy.

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

Parametry

NazwaTypOpis
queryStringciąg tekstowy do wyszukania w polu firmy kontaktu;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do określonej wartości w polu niestandardowym.

Pole niestandardowe może być określone jako ciąg znaków lub jako jedna z wartości ContactsApp.ExtendedField.

// 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',
);

Parametry

NazwaTypOpis
queryObjectciąg znaków, którego szukać w polu niestandardowym kontaktu;
labelExtendedFieldpole niestandardowe, w którym chcesz przeprowadzić wyszukiwanie;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobiera kontakty pasujące do danego miesiąca i dnia w przypadku konkretnego pola standardowego.

// 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,
);

Parametry

NazwaTypOpis
monthMonthmiesiąc do dopasowania, jako jedna z wartości w ContactsApp.Month
dayIntegerdzień dopasowania
labelFieldpole do wyszukiwania z ContactsApp.Field

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobiera kontakty pasujące do danego miesiąca, dnia i roku w przypadku konkretnego pola standardowego.

// 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,
);

Parametry

NazwaTypOpis
monthMonthmiesiąc do dopasowania, jako jedna z wartości w ContactsApp.Month
dayIntegerdzień dopasowania
yearIntegerrok dopasowania, może być pusty
labelFieldpole do wyszukiwania z ContactsApp.Field

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobiera kontakty, które w danym polu niestandardowym pasują do podanego miesiąca, dnia i roku.

// 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',
);

Parametry

NazwaTypOpis
monthMonthmiesiąc do dopasowania, jako jedna z wartości w ContactsApp.Month
dayIntegerdzień dopasowania
yearIntegerrok dopasowania, może być pusty
labelStringpole niestandardowe, w którym chcesz przeprowadzić wyszukiwanie;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobiera kontakty, które w danym polu niestandardowym odpowiadają podanemu miesiącowi i dniu.

// 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',
);

Parametry

NazwaTypOpis
monthMonthmiesiąc do dopasowania, jako jedna z wartości w ContactsApp.Month
dayIntegerdzień dopasowania
labelStringpole niestandardowe, w którym chcesz przeprowadzić wyszukiwanie;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do adresu e-mail.

// The code below returns an array of contacts where the contact's email address
// contains "john.doe@example.com'.
const contacts = ContactsApp.getContactsByEmailAddress('john.doe@example.com');

Parametry

NazwaTypOpis
queryStringciąg tekstowy do wyszukania w adresach e-mail kontaktów;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do adresu e-mail, ograniczone do określonego pola.

// The code below returns an array of contacts where the contact's email address
// contains "john.doe@example.com" in the Home email field.
const contacts = ContactsApp.getContactsByEmailAddress(
    'john.doe@example.com',
    ContactsApp.Field.HOME_EMAIL,
);

Parametry

NazwaTypOpis
queryStringciąg tekstowy do wyszukania w adresach e-mail kontaktów;
labelFieldpole, w którym ma być przeprowadzone wyszukiwanie;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do adresu e-mail, ograniczone do określonej etykiety niestandardowego adresu e-mail.

// The code below returns an array of contacts where the contact's email address
// contains "john.doe@example.com" in a custom email address label (created by
// the user) called "alternate".
const contacts = ContactsApp.getContactsByEmailAddress(
    'john.doe@example.com',
    'alternate',
);

Parametry

NazwaTypOpis
queryStringciąg znaków, którego szukać w adresach e-mail kontaktów z określoną etykietą adresu e-mail
labelStringetykietę adresu e-mail do wyszukiwania w ramach

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów z danej grupy kontaktów.

// 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);

Parametry

NazwaTypOpis
groupContactGroupgrupy kontaktów

Powrót

Contact[] – tablica kontaktów w danej grupie

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do adresu czatu.

// 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');

Parametry

NazwaTypOpis
queryStringciąg tekstowy do wyszukania w adresach czatów kontaktów

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do adresu czatu, ograniczone do określonego pola.

// 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,
);

Parametry

NazwaTypOpis
queryStringciąg tekstowy do wyszukania w adresach czatów kontaktów
labelFieldpole, w którym ma być przeprowadzone wyszukiwanie;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do adresu czatu ograniczone do określonej niestandardowej etykiety czatu.

// 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');

Parametry

NazwaTypOpis
queryStringciąg znaków do wyszukania w adresach kontaktów w programie do obsługi wiadomości błyskawicznych z określoną etykietą wiadomości błyskawicznych
labelStringetykiety czatu do wyszukiwania w ramach

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do pola „Stanowisko”.

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

Parametry

NazwaTypOpis
queryStringciąg tekstowy do wyszukania w polu stanowiska kontaktu;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do nazwy.

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

Parametry

NazwaTypOpis
queryStringciąg tekstowy do wyszukania w nazwach kontaktów.

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do nazwy, ograniczone do określonego pola.

// 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,
);

Parametry

NazwaTypOpis
queryStringciąg tekstowy do wyszukania w nazwach kontaktów.
labelFieldpole, w którym ma być przeprowadzone wyszukiwanie;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobierz kontakty pasujące do pola notatek.

// 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');

Parametry

NazwaTypOpis
queryStringciąg tekstowy do wyszukania w polu Uwagi kontaktu;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do numeru telefonu.

Ta metoda rozszerza numery telefonów z literami, więc jeśli szukasz numeru „212-555-KOD”, a masz w kontaktach numer „212-555-2633” lub odwrotnie, metoda znajdzie odpowiedni kontakt.

// 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');

Parametry

NazwaTypOpis
queryStringciąg tekstowy do wyszukania w numerach telefonów kontaktów;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do numeru telefonu, ograniczone do konkretnego pola.

Ta metoda rozszerza numery telefonów z literami, więc jeśli szukasz numeru „212-555-KOD”, a masz w kontaktach numer „212-555-2633” lub odwrotnie, metoda znajdzie odpowiedni kontakt.

// 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,
);

Parametry

NazwaTypOpis
queryStringciąg tekstowy do wyszukania w numerach telefonów kontaktów;
labelFieldpole, w którym ma być przeprowadzone wyszukiwanie;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do numeru telefonu, ograniczone do określonej niestandardowej etykiety numeru telefonu.

Ta metoda rozszerza numery telefonów z literami, więc jeśli szukasz numeru „212-555-KOD”, a masz w kontaktach numer „212-555-2633” lub odwrotnie, metoda znajdzie odpowiedni kontakt.

// 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');

Parametry

NazwaTypOpis
queryStringciąg tekstowy do wyszukania w numerach telefonów kontaktów z określoną etykietą numeru telefonu niestandardowego
labelStringetykietę numeru telefonu, w której chcesz przeprowadzić wyszukiwanie;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do adresu URL.

// 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');

Parametry

NazwaTypOpis
queryStringciąg tekstowy do wyszukania w adresach URL kontaktów;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do adresu URL, ograniczone do konkretnego pola.

// 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,
);

Parametry

NazwaTypOpis
queryStringciąg tekstowy do wyszukania w adresach URL kontaktów;
labelFieldpole, w którym ma być przeprowadzone wyszukiwanie;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też


Wycofany. Ta funkcja została wycofana i nie należy jej używać w nowych skryptach.

Pobieranie kontaktów pasujących do adresu URL, ograniczone do określonej etykiety niestandardowego adresu URL.

// 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',
);

Parametry

NazwaTypOpis
queryStringciąg znaków do wyszukania w adresach URL kontaktów z określoną etykietą adresu URL niestandardowego;
labelStringetykietę niestandardowego adresu URL, w której chcesz przeprowadzić wyszukiwanie;

Powrót

Contact[] – tablica pasujących kontaktów

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

Zobacz też