{"id":13585671,"url":"https://github.com/desko27/gcontacts-extractor","last_synced_at":"2025-04-07T10:31:28.077Z","repository":{"id":27031088,"uuid":"30495958","full_name":"desko27/gcontacts-extractor","owner":"desko27","description":":notebook: An admin CLI tool to get Google Contacts' mails from your Google Apps users.","archived":false,"fork":false,"pushed_at":"2018-03-02T09:41:54.000Z","size":22,"stargazers_count":5,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-02-14T21:14:21.453Z","etag":null,"topics":["cli","contacts","gmail","google-apps","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/desko27.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-02-08T15:50:37.000Z","updated_at":"2021-10-02T09:50:42.000Z","dependencies_parsed_at":"2022-08-03T06:30:41.611Z","dependency_job_id":null,"html_url":"https://github.com/desko27/gcontacts-extractor","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/desko27%2Fgcontacts-extractor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/desko27%2Fgcontacts-extractor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/desko27%2Fgcontacts-extractor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/desko27%2Fgcontacts-extractor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/desko27","download_url":"https://codeload.github.com/desko27/gcontacts-extractor/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223278037,"owners_count":17118713,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","contacts","gmail","google-apps","python"],"created_at":"2024-08-01T15:05:04.409Z","updated_at":"2024-11-06T03:31:40.381Z","avatar_url":"https://github.com/desko27.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# gcontacts-extractor\n\n[![Build Status](https://travis-ci.org/desko27/gcontacts-extractor.svg?branch=master)](https://travis-ci.org/desko27/gcontacts-extractor)\n[![Codacy Badge](https://www.codacy.com/project/badge/8077cc0440db43709c6b554a2d51a3b6)](https://www.codacy.com/public/desko27/gcontacts-extractor)\n[![Gitter chat](https://badges.gitter.im/desko27/gcontacts-extractor.png)](https://gitter.im/desko27/gcontacts-extractor \"Gitter chat\")\n\nThis script is intended for extracting contact's addresses from a specified\nset of Google Apps users. To do that, it connects to the\n[Google Contacts API version 3.0](https://developers.google.com/google-apps/contacts/v3/)\nand iterates over the passed list of accounts.\n\n## Usage\n\n```\ngcontacts-extractor.py [-d=\u003cdomain\u003e] [-s] [-k] (-f | \u003csource-accounts\u003e ...)\n```\n\n## Howto\n\n1. [Create a service account](https://developers.google.com/identity/protocols/OAuth2ServiceAccount#creatinganaccount) in Google Apps console and paste `service_account_keys.json` in the settings folder.\n2. [Authorize the contacts scope](https://developers.google.com/identity/protocols/OAuth2ServiceAccount#delegatingauthority) for the service account: `https://www.google.com/m8/feeds/`.\n3. Copy sample config files and remove their `.sample` extension.\n4. Set default_domain in `conf.ini` as your Google Apps domain.\n5. Run `gcontacts-extractor.py -s bob jack sally` __note*__.\n6. You've got `bob.txt`, `jack.txt` and `sally.txt` text files containing all of their mail addresses.\n\n__note*__ → the domain here is implied since it is previously defined in `conf.ini`, so when you write `bob` the script is actually understanding `bob@yourdomain.com` and so on.\n\n## Options\n  \n```\n-h --help\n-d --domain=\u003cdomain\u003e  override default domain\n-s --separated        send output to separated files (per account)\n-k --keep             keep previous results on the output folder\n-f --from-file        get source accounts from file instead of from arguments\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdesko27%2Fgcontacts-extractor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdesko27%2Fgcontacts-extractor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdesko27%2Fgcontacts-extractor/lists"}