Add a "Get Help" link or link within the existing text for users who encounter the google_api_connection_fail error about site-kit-wp

[tofumatt]

As mentioned in Slack: let's keep that message in there 😄

[nfmohit]

Thank you folks! I've opened a follow-up PR #8028 that restores this text. Thanks!

[mxbclang]

Noting that the longer-term goal would be to implement #7986 to block users from proceeding with setup in this case. This would be a shorter-term solution prompting them to get help in order to proceed.

[mxbclang]

Per discussion with @aaemnnosttv, this should be a small change to update this specific case, and we'll need to determine if this error ID needs to be added to the related sheet. Moving to AC.

[techanvil]

IB ✅

@eugene-manuilov, tagging you as a heads up re. the IB point about this needing a Service Engineering task.

Update: Looks like this is already covered on Slack.

[wpdarren]

QA Update: ❌

@nfmohit I have two observations that I'd like to raise.

1. I see the message highlighted in the initial ticket description on the latest release. When I switch to the develop branch, though, a different message appears. Looks like your site is having a technical issue with requesting data from Google services The AC doesn't refer to a change in the message so wanted to check.

2. The URL on the "Get Help" link points to the URL in the AC, but when I click the link, I am redirected to the support forum. Is that expected right now? This issue is expected until the updates are in production. I have created an Asana task to check this as part of my post-release testing.

[nfmohit]

Hi @wpdarren, thank you for sharing your observations.

1. I see the message highlighted in the initial ticket description on the latest release. When I switch to the develop branch, though, a different message appears. Looks like your site is having a technical issue with requesting data from Google services The AC doesn't refer to a change in the message so wanted to check.

The part that I removed ("To get more help, ask a question on our support forum and include the text of the original error message: google_api_connection_fail") is already covered in the linked documentation, so I don't think there's much point in including that again in the message. Also, this follows the pattern of other similar error messages in this context which also have a "Get help" link.

@tofumatt As you had authored the ACs here, just to confirm, do you think it is still necessary to include this part in the error message?

Thank you!

[wpdarren]

QA Update: ❌

@nfmohit I apologize in advance for being picky, but as QA, it is what I do. 😄

Could we have the google_api_connection_fail text on the same line above, next to message:

It just looks a bit odd underneath.

Also, I noticed a difference in the URLs.

On the AC. https://sitekit.withgoogle.com/documentation/troubleshooting/setup/#google_api_connection_fail
On my test site: https://sitekit.withgoogle.com/support?error_id=google_api_connection_fail
It's worth noting the QAB states https://sitekit.withgoogle.com/support?error_id=google_api_connection_fail

Have I missed something here?

[nfmohit]

Hi @wpdarren.
Thank you for sharing your observation.

Could we have the google_api_connection_fail text on the same line above, next to message:

It just looks a bit odd underneath.

I understand, however, this is the pre-existing structure of error messages like these. This issue doesn't change the structure of the message but adds to it. Here is a similar error message:

For consistency, do you think it would be nicer to change all of them in a different issue?

Also, I noticed a difference in the URLs.

On the AC. https://sitekit.withgoogle.com/documentation/troubleshooting/setup/#google_api_connection_fail On my test site: https://sitekit.withgoogle.com/support?error_id=google_api_connection_fail It's worth noting the QAB states https://sitekit.withgoogle.com/support?error_id=google_api_connection_fail

https://sitekit.withgoogle.com/documentation/troubleshooting/setup/#google_api_connection_fail is the actual URL for the documentation.

https://sitekit.withgoogle.com/support?error_id=google_api_connection_fail is our proxy URL which will ultimately redirect the user to the actual documentation once the updates in the service side are pushed to production (see point #2 of this comment).

Please let me know what you think, thanks!

[wpdarren]

QA Update: ✅

Thanks, @nfmohit, that all makes sense.

For consistency, do you think it would be nicer to change all of them in a different issue?

Yes, I will create a new ticket for all of these messages.

Your example has bad formatting, so we should look to tidy it up, but it is a low priority in the scheme of things!

Verified:

• The error message described in the issue appears.
• The "Get help" link points to this URL: https://sitekit.withgoogle.com/support?error_id=google_api_connection_fail