Allow Speakap to publish and manage your Android White-Label App | Full Walkthrough

Introduction

Following the below steps will grant Speakap the ability to publish your white-label app quickly and securely. This will ensure that your organization is always using the latest version of the application. Following this guide will take about 30 minutes and can be completed by any non-technical member of your organization. 

Need help? Let us know! Please send an email to support@speakap.com and someone will be in touch to help you through the process.

If you are technically familiar with the process, you may follow our brief guide: Brief Walkthrough

Glossary

Video Walkthrough 

Click here to open the video in a new tab (or click on a timestamp above)

Chapter 1) Create a Google Gmail Account for your organization

1. Click here and create a Google Gmail Account: https://accounts.google.com/signup

  • This is just a regular Google Gmail Account that you can tailor to your organization’s preference. We will publish your Speakap Android White-Label App under this account

mceclip0.png

 

Chapter 2) Upgrade your Google Gmail Account to a Google Developer Account

1. Click here: https://play.google.com/apps/publish/

2. Login with the Google Account you previously created which should take you to the below page

mceclip1.png

3. Accept the developer agreement and Click the Continue to Payment button

mceclip2.png

4. Complete the Purchase details to upgrade your account to a Google Developer Account then click the Buy button

  • This is a $25.00 fee for a registered developer account which is necessary to publish your app

mceclip3.png

5. Complete the Developer Profile details and click the Complete Registration button at the bottom of the page

  • Developer Name: The developer name is displayed to users under the application name in the Google Play store and can be changed later
  • Email Addressmobile-development@speakap.nl
    • This ensures Speakap will receive notifications from Google regarding your app

mceclip4.png

mceclip5.png

 

Chapter 3) Create a Google Developer Project and Application

1. Click here: https://play.google.com/apps/publish

  • Login with the same Google Account which should take you to the below page
  • The last step in Chapter 2 will have also brought you to this page

mceclip5.png

2. Click All applications from the left-hand menu

mceclip4.png

3. Click the Create Application button on the right-hand area of the page

mceclip3.png

4. Enter a temporary app Title (we will fill in the details later) leave the Default language as “English (United States) – en-US

  • The Title is the name of the app that appears on the Google Play Store page.
  • Title can be changed later

5. Click the Create button

mceclip2.png

6. Click All applications on the left-hand menu

  • Make no other changes on this page

mceclip1.png

7. Click Settings on the left-hand menu

mceclip0.png

8. Click Developer account to expand this menu

mceclip13.png

9. Click API access

mceclip12.png

10. Accept the Terms of Service

mceclip11.png

11. Click the Create New Project button

mceclip10.png

12. Click the Create Service Account button at the bottom of the page

mceclip9.png

13. Click the Google API Console Link as noted in Step 1 of this window (Do not click Done) and Continue with Chapter 4

  • Leave this window open, as we will be returning to this window later to press the Done button

 mceclip8.png

 

Chapter 4) Create a Service Account and provide Speakap access

1. Click here: https://console.developers.google.com/iam-admin/serviceaccounts

  • Login with the same Google Account which should take you to the below Service accounts page
  • The last step in Chapter 3 will have also brought you to this page

mceclip6.png

2. Click Select a project at the top-left of the page

  • If it already lists Google Play Android Developer then skip to Step 5

mceclip7.png

3. Click a Google Play Android Developer from the next window to select it

mceclip8.png

4. Now there should be a Project selected at the top of the Service accounts page

mceclip9.png

5. Click the Create Service Account button on the right-hand side of the window

mceclip10.png

6. Enter the Service Account Name as “speakap-automation” and click the Create button

  • You can ignore the Service account ID and Service account description fields

mceclip11.png

7. Assign Service account permissions by following the below steps

  1. Click the Select a role box
  2. Select Service Accounts from the left-hand list
  3. Select Service Account User from the right-hand list after you selected Service Accounts

mceclip12.png

8. Click the Continue button once Service Account User has been selected as a role

mceclip13.png

9. Click the Create Key button under the Create Key (optional) section

  • You can ignore the two Grant access to this service account fields and leave them blank

mceclip14.png

10. Click the JSON Checkbox then click the Create button

mceclip15.png

11. Upon clicking the Create button, a file will be downloaded to your computer and you can click the Close button

  • This file is very important to Speakap and must be emailed to us 
  • Please email this file to your Speakap Customer Success Manager
  • The filename will be similar to “api-8451553770874210560-341072-a17ed5811f72.json” but it will be unique for you
  • Anyone who has this file could gain access to your account, so keep the file secure!

mceclip16.png

12. Click the Done button at the bottom of the page

mceclip17.png

13. Send an email to your Speakap Customer Success Manager with this file attached

  • We need this file to publish your app, so please email it to us via an email attachment
  • Mention your company name and white-label app name in the email
  • Any email application can be used to send this email (macOS Mail, Gmail, Outlook, etc.)

Screenshot_2019-10-16_at_16.44.39.png

Chapter 5) Grant Speakap access to your Developer Account and Service Account

Firstly, we will grant Speakap access to the Service Account 

1. Navigate back the previous window you left open from Chapter 3 and click the Done button

mceclip19.png

2. You should see the below API Access page

mceclip20.png

3. Scroll to the bottom of the page to the Service Accounts section and click the Grant Access button

mceclip21.png

4. Set the Expiry Date to “Never”, and Role to “Release Manager” and do not change the email

  • Email: do not change the email
  • Access expiry date: Never
  • Role: Release Manager

mceclip22.png

  • Optionally, it is acceptable to define a Custom Role instead of the above Release manager Role if access must be limited to only the Speakap White-label App
    • Click the "Add an app" drop-down list and select your white-label app name
    • Please check all the boxes under the selected app to ensure we have all necessary permissions for Release manager role

Screenshot_2020-04-15_at_15.23.49.png

5. Scroll to the bottom of the page and click the Add User button

mceclip23.png

6. After clicking Add User, you should now be on the Users & permissions page

mceclip24.png

 

Secondly, we will grant Speakap access to the Developer Account

7. You should still be on the User & permissions page. Click the Invite New User button in the top-right area of the window

mceclip25.png

8. Fill out the form exactly as highlighted in the below screenshot:

  • Email: mobile-development@speakap.nl
  • Access expiry date: Never
  • Role: Administrator

Screenshot_2019-07-15_at_14.43.37.png

  • Optionally, it is acceptable to define a Custom Role instead of the above Administrator Role if access must be limited to only the Speakap White-label App
    • Click the "Add an app" drop-down list and select your white-label app name
    • Please check all the boxes under the selected app to ensure we have all necessary permissions

Screenshot_2020-04-15_at_13.08.26.png

9. Scroll to the bottom of the window and click the Send Invitation button

mceclip27.png

10. The invitation that you just sent will appear under Pending Invitations until Speakap accepts the invitation. Then it will appear under Users with access.

mceclip28.png

11. Congratulations you have completed all the requested steps! Thank you for your time!

  • We recommend you follow the following Checklist to ensure no critical steps were missed

 

Chapter 6) Checklist and Troubleshooting

1. Check that you sent the downloaded JSON file through email to your Speakap Customer Success Manager as requested in Chapter 5 – Step 13-15

2. Click here: https://play.google.com/apps/publish/#AdminPlace

3. Login with the same Google Account

4. You should see three entries under the Users with access section

  • If you do not see an entry for mobile-development@speakap.nl, refer to Chapter 5 - Step 7
  • If you do not see an entry for “speakap-automation…”, refer to Chapter 5 – Step 1

 mceclip29.png

 

Was this article helpful?
0 out of 0 found this helpful