Class ContactGroup

Skontaktuj się z firmąGroup

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

KontaktGroup to grupa kontaktów.

MetodaZwracany typKrótki opis
addContact(contact)ContactGroupDodaje dany kontakt do tej grupy. 
// The code below creates a new contact and adds it to the "Work Friends"
// contact group
const contact = ContactsApp.createContact(
    'John',
    'Doe',
    'john.doe@example.com',
);
const group = ContactsApp.getContactGroup('Work Friends');
group.addContact(contact);
deleteGroup()voidUsuwa tę grupę kontaktów.
getContacts()Contact[]Pobiera wszystkie kontakty z tej grupy kontaktów.
getGroupName()StringZwraca nazwę tej grupy.
getId()StringPobiera identyfikator tej grupy kontaktów.
getName()StringPobiera nazwę tej grupy kontaktów.
isSystemGroup()BooleanPobiera wartość logiczną, która określa, czy ta grupa kontaktów jest grupą systemową (nie można jej usunąć) czy nie.
removeContact(contact)ContactGroupUsuwa dany kontakt z tej grupy. 
// The code below retrieves all the contacts named "John Doe' and removes them
// from the "Work Friends" contact group
const contacts = ContactsApp.getContactsByName('John Doe');
const group = ContactsApp.getContactGroup('Work Friends');
for (const i in contacts) {
  group.removeContact(contacts[i]);
}
setGroupName(name)voidOkreśla nazwę tej grupy.
setName(name)ContactGroupUstawia nazwę tej grupy kontaktów.

Wycofane metody

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

Dodaje dany kontakt do tej grupy. 

// The code below creates a new contact and adds it to the "Work Friends"
// contact group
const contact = ContactsApp.createContact(
    'John',
    'Doe',
    'john.doe@example.com',
);
const group = ContactsApp.getContactGroup('Work Friends');
group.addContact(contact);

Parametry

NazwaTypOpis
contactContactkontakt, który ma zostać dodany do grupy;

Powrót

ContactGroup – ta 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.

Usuwa tę grupę kontaktów.

Usuwanie dotyczy tylko grup niesystemowych, ponieważ grup systemowych nie można usuwać. 

// The code below retrieves a contact group named "Work Friends" and deletes it
const group = ContactsApp.getContactGroup('Work Friends');
group.deleteGroup();

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 z tej grupy kontaktów. 

// The code below retrieves all the contacts in the group named "Work Friends"
const group = ContactsApp.getContactGroup('Work Friends');
const contacts = group.getContacts();

Powrót

Contact[] – kontakty w tej 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

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

Zwraca nazwę tej grupy.

Powrót

String – nazwa tej grupy

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 identyfikator tej grupy kontaktów. 

// The code below retrieves a contact group named "Work Friends" and gets its id
const group = ContactsApp.getContactGroup('Work Friends');
const id = group.getId();

Powrót

String – identyfikator tej grupy

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 nazwę tej grupy kontaktów. 

// The code below creates a new contact group and then retrieves its name
const group = ContactsApp.createContactGroup('Work Friends');
const name = group.getName();

Powrót

String – nazwa tej 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 wartość logiczną, która określa, czy ta grupa kontaktów jest grupą systemową (nie można jej usunąć) czy nie.

Grupy systemowe to zestaw grup wstępnie zdefiniowanych w Kontaktach Google, takich jak „Moje kontakty”, „Rodzina”, „Współpracownicy” itp. Nazwa grupy systemowej zwykle zawiera wyraz „Grupa systemowa”. 

// The code below retrieves two contact groups, then logs whether or not
// each is a system group.
const myGroup = ContactsApp.getContactGroup('Work Friends');
const systemGroup = ContactsApp.getContactGroup('System Group: Coworkers');
Logger.log(myGroup.isSystemGroup());      // Returns false, if the group exists.
Logger.log(systemGroup.isSystemGroup());  // Returns true.

Powrót

Boolean – czy dana grupa kontaktów jest grupą systemową

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.

Usuwa dany kontakt z tej grupy. 

// The code below retrieves all the contacts named "John Doe' and removes them
// from the "Work Friends" contact group
const contacts = ContactsApp.getContactsByName('John Doe');
const group = ContactsApp.getContactGroup('Work Friends');
for (const i in contacts) {
  group.removeContact(contacts[i]);
}

Parametry

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

Powrót

ContactGroup – ta 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.

Określa nazwę tej grupy.

Parametry

NazwaTypOpis
nameStringnazwę do ustawienia dla tej grupy.

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.

Ustawia nazwę tej grupy kontaktów. 

// The code below retrieves the contact group named "Work Friends" and renames
// it to "Work Buddies"
const group = ContactsApp.getContactGroup('Work Friends');
group.setName('Work Buddies');

Parametry

NazwaTypOpis
nameStringnowa nazwa grupy kontaktów.

Powrót

ContactGroup – ta 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ż