11

We have and

The first was used on questions about a Google API and Google Apps Script Service (Class ContactsApp) that are now deprecated and retired but also on questions about Google Contacts, the cross-platform app linked to Gmail and other Google cross-platform apps.

These tags should not be made synonyms because the code used with Contacts API doesn't work with the People API; it's required to migrate.

The page about Google Contacts API now points to the Contacts API migration to the People API page hosted on the People API microsite on https://developers.google.com.

One of the "problems" with is that it's being added by "default" in questions related to handling contacts on Google Contacts and other Google apps.

  • Should we edit the excerpt to add something like "DO NOT USE ON NEW QUESTIONS"?

  • Is it possible / a good idea to add a tag warning to be applied to all new questions, considering that the Google Contacts API is deprecated and retired?


Note:

This is a "Google" classic. Not too long ago, we have Should we merge Google Hangouts tags with Google Chat?.

The case depicted in this question differs from the Hangouts / Chat case because it is not about having two brands and two tags. In this case, only one consumer app matches one of the API names, Google Contacts, and also matches the name of the entity / record type used on Gmail and other apps: contact.

Another important difference is that in the previous post, some code still works, but the code using the Contact API doesn't work anymore.

Related

5
  • 3
    What do you mean by being added by "default"? No tags are defaulted.
    – Thom A
    Commented Oct 2, 2023 at 20:47
  • 3
    @ThomA google-contacts-api might be suggested by the system based on the question content when the question creator starts to type contact. Then the question creator selects it because it can't create a new tag because it looks good idea among many other possibilities
    – Wicket
    Commented Oct 2, 2023 at 20:52
  • I have a suggestion which can't be handled on SO Meta on its own: why can't we have a tag "frozen" property/flag? Such flag would allow search by tag, but prohibit adding it to new questions (can be edited into old quetions). If it's selected for implementation, it can be simplified to just "ask mods to add this flag", and then all questions about "thing tag X refers to is dead, what to do with tag X?" can be resolved by marking X as frozen. It helps to retain old knowledge base (if I read some very old code, I may still be interested in old answers) and prevent tag misuse.
    – STerliakov
    Commented Oct 3, 2023 at 14:29
  • 2
    @STerliakov: So technically, I believe that is how (at least some) tag blocks work. On its own, a tag block prevents the tag from being added to new questions/articles, but it doesn't remove it from the questions/articles it's already on. (That's why the first step of requesting a tag block is generally to burninate the problem tag.) That said, I don't think there's really a precedent for blocking a tag but letting it stick around on existing questions.
    – V2Blast Staff
    Commented Oct 3, 2023 at 17:30
  • 6
    @STerliakov If you read some very old code, you might have new questions, which arguably should still get the old tag.
    – 9072997
    Commented Oct 3, 2023 at 17:42

3 Answers 3

10

I agree with the recommendations in the question:

Just a tag warning along the following lines is preferable.

This api is deprecated. Did you mean google-people-api or the product google-contacts?

I'm against closing old questions or blocking the tag entirely.

Rationale:

  1. The tag may still be of historic value. Some Old APIs may still work. Some methods/techniques in answers may provide hints on using the new API.

  2. Domain shared contacts API (, which is not deprecated) is strongly associated with google-contacts-api and AFAIK, they still use the old contacts oauth scopes

  3. Users may still ask questions about migration, equivalent/comparable methods in old and new APIs.

3
  • Most questions tagged with google-contacts-api are about the Google Contacts API and dependent Google Apps Script services. The Google Contacts API is deprecated and retired so questions that are specific about this API or the dependent services should be closed as the code in the questions and answers don't work anymore. The exception might a question asking how to do something and the answer suggested to use the API, then an ew answer could suggest to use another API.
    – Wicket
    Commented Oct 4, 2023 at 18:49
  • If there are questions tagged google-contacts-api about Google Contacts, Google Workspace Directory (shared contacts) I think that they should be retagged. Many migration questions that I have seen are very similar to "translation" questions, instead of talking about the deprecated API they should describe what the code does, sometimes the old code is just dead weight, in those cases the old code and tag of the deprecated API should not be included.
    – Wicket
    Commented Oct 4, 2023 at 18:50
  • @Rubén I'm not convinced about closing such questions, as I believe they have historical value. Recently, one of my questions were closed for a similar scenario. Anyway, I want the community to decide on the consensus. So, I asked Should reproducible questions, which becomes non-reproducible be closed and/or downvoted?. Feel free to share your opinions.
    – TheMaster
    Commented Oct 8, 2023 at 19:04
0

There is retag project from 2019 Should questions with tag [contacts] be retagged?. This missed the fact that is a synonym of and that there are some questions (76) questions that are tagged . Some aren't about the Google Contacts API.

These questions might need to be retagged, based on the above link

=> .

Unless the question is really about using the Google Contacts API, in such a case, the question should be flagged / voted to close as no longer reproducible because the API is deprecated and retired as the code no longer works, nobody can have a library or service instance running on-premise, self-hosted, or alike.

P.S. The first question that I found with was not about programming.

3
  • 2
    Android contacts are usually Google contacts. In any case, I don't think closing "old" questions carries any good, especially just because the related api is deprecated.
    – TheMaster
    Commented Oct 4, 2023 at 10:18
  • @TheMaster in the case of the Google Contacts API it's deprecated and retired. I edited the answer to clarify this.
    – Wicket
    Commented Oct 4, 2023 at 19:00
  • 2
    Just because Google retires products faster than my niece changes her hairstyle doesn't mean we should be closing all the questions about those products. What harm is produced by having a [google-contacts-api] question, that was asked several years ago, open or otherwise available? The worst that can happen is that someone copy-pastes the code without understanding and it doesn't work. Big deal. Already happens several (thousand) times a day. Maybe people will stop with the copy-pasta already. Commented Oct 4, 2023 at 21:11
0

In one of the previous answers, it was mentioned .

This brought to my attention that several questions tagged with and/or with are also tagged with and .

has marked as "DO NOT USE" and it has a -> Confusing tag [Google-api-client]

So, things to take in mind, some people calls "API" whatever lets them interact with a Google service in one way or another. Still, Google has a lot of stuff around Google Contacts (the web and mobile apps) and Domain Directory (Google Workspace aka a platform to manage accounts and services) that use "contacts" that still works, like URL for OAuth scopes, and URLs of endpoints that belong to other APIs for which Google use a different brand. Still, askers see "contacts" and someway select .

If the question is about Class ContactsApp from Google Apps Scripts they should be closed as obsolete as this code doesn't work and the migration is not easy.

Other questions using should be carefully reviewed. If they are about Google Contacts API and not about something having "contacts" that misled the OP to select the , and the question is specific about the API and not about making mention of it in an incidental way, it should be closed.

Questions that are wrongly using should be retagged.

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .