Reseller portal guide

Resellers, customers, and Return Merchandise Authorization (RMA) agents all use the zero-touch portal to prepare devices and configurations for zero-touch enrollment. This guide helps enrolled device resellers use the portal. If you're a customer, visit the Android Enterprise help center.

Resellers are companies that distribute Android devices for zero-touch enrollment. As a reseller, you use the portal to manage your customers and register devices to them. To help you do this, use the portal to:

  • Create customer accounts.
  • View all available customers.
  • Search for devices.
  • Register or deregister devices.

Get started

If you're the first person from your organization to use the portal, fill out the Android Zero-Touch Application Form to apply for access. You'll need a Google Account, associated with your corporate email, to use the portal. See Associate a Google Account below. You can't use your personal Gmail account with the portal.

Associate a Google Account

If you don't have a Google Account associated with your corporate email, follow the steps below:

  1. Go to Create your Google Account.
  2. Enter your name.
  3. Set Your email address to your corporate email. Don't click I would like a new Gmail address.
  4. Complete the remaining account information.
  5. Click Next step.
  6. Follow the on-screen instructions to finish creating your account.

We recommend enabling 2-Step Verification on a Google Account like this that's used for administrative purposes. 2-step verification adds an extra layer of security to your account. See the Google Account help center to help you and learn more about your new account.

Request portal access

Follow the steps below to request access for an organization:

  1. Send your corporate email to your Android Platform Solutions Consultant. This is the same email address you associated your Google Account with.
  2. Include a list of other users in your organization who you'd like to have access to the portal. Each user will need to associate a Google Account with their corporate email.
  3. Include the name of your organization, as you'd like your customers to see it in their portal.
  4. Your Platform Solutions Consultant will create a portal account for you. Members of the account have access to the portal.
  5. After you get access, sign in to the portal using your corporate email address.

When people join the team, you can give them portal access by following the steps in Add team members.

Work with customers

Your customers use the portal to map devices to the EMM configs that provision those devices. Add your customers in the portal to give them access. After you add a customer to the portal, your organization can register devices for the customer.

View customers

To see all your customers:

  1. Open the portal. You might need to sign in.
  2. Click group Customers in the sidebar.

To see your vendors' customers:

  1. Open the portal. You might need to sign in.
  2. Click group Customers in the sidebar.
  3. Select the vendor from Resellers above the table.

A table lists your customers. Each row shows the customer's name and their unique customer ID.

Add a customer

You can set up a new customer account in the portal. After you create a customer in the portal, they manage their employees' portal access.

Before you add a new customer, you need the following information.

  • A customer name so you can find the customer in your portal. The customer name doesn't have to be unique, but it's easier to find customers if you name each one uniquely.
  • Ask the customer to supply at least one Google Account to be the owner. The owner can add and remove users and other owners later. If the customer needs help associating the account, send the instructions from Associate a Google Account above.

To create a customer account, follow the steps below:

  1. Open the portal. You might need to sign in.
  2. Click group Customers in the sidebar.
  3. Click add Add Customer.
  4. Give the customer a name.
  5. Set the customer account owner in Manager email.
  6. Optionally, add comma-separated email addresses for other employees that need to access the portal.
  7. Check the details you've entered—you can't edit or delete a customer after you create one.
  8. Click Add.

Manage devices

After your customers purchase devices, they'll want to configure provisioning settings for these devices in their ZTP account. Assigning a device adds the device to ZTP and shows the device in the customer's view of the portal. In the portal, you can:

  • Find devices.
  • Assign devices to customers.
  • Deregister devices from customers.
  • Import and export CSV data.

Find devices

You can use the portal to find devices your organization (or your vendors) registered to customers. Find devices by hardware IDs or by the customer who purchased the device. To find devices, follow the steps below:

  1. Click important_devices Device Search.
  2. Select a hardware ID or customer attribute from Choose search criteria.
  3. Enter a full identifier value or part of a customer's name.
  4. Click search Search.

The Registered devices table lists any devices found. To find the vendor of a device check look in the Reseller name column. If your search doesn't match any devices, you see the message No devices found in the table.

Assign devices

You register devices to a customer by uploading a CSV file.

Registering a device adds it to ZTP and shows the device in the customer's view of the portal. Each row in the CSV file lists the customer ID that you want to assign the device to.

Prepare a CSV file containing your device and customer information. You can download a sample file from the Device upload page in the portal to help you get started. Alternatively, if you want to start with a blank file, learn about the fields needed by reading Import CSV file format.

Check that the CSV file you upload to the portal is smaller than 50 MB because that's the largest file the portal accepts. If you have more than 50 MB of data, consider splitting the file into smaller files. When you've prepared your CSV file, follow the steps below:

  1. Open the portal. You might need to sign in.
  2. Click cloud_upload Device upload in the sidebar.
  3. Click file_upload Upload.
  4. Select your CSV file from the file picker.

After the file uploads, the portal processes the data rows. When processing finishes, the portal shows a notification with a link to an upload status page. You also receive an email summarizing the processing of your CSV data. Click the See details button in the email to open a status page. The status page lists each device that wasn't assigned to a customer with a reason for the error.

If you close your browser window after the CSV file uploads, the portal continues to process your data. To know when the portal finishes processing your data, check your email inbox for the status email.

The devices appear in your customer's portal after processing has finished. When you receive the processing summary email, check for any errors, and if everything went well, let your customer know that they can see the purchased devices in their portal.

Import CSV file format

To register devices to your customer's account, you upload a CSV file. The following snippet shows the CSV field format with example values for a device with a cellular modem:

modemtype,modemid,manufacturer,profiletype,owner
IMEI,123456789012347,Google,ZERO_TOUCH,54321

To identify Wi-Fi-only devices, such as tablets, you can use the serial and model fields:

serial,model,manufacturer,profiletype,owner
ABcd1235678,VM1A,Honeywell,ZERO_TOUCH,54321

You can also register both types of devices from the same CSV file:

modemtype,modemid,serial,model,manufacturer,profiletype,owner
IMEI,123456789012347,,,Google,ZERO_TOUCH,54321
,,ABcd1235678,VM1A,Honeywell,ZERO_TOUCH,54321

Table 1 shows the field values you use in your CSV file:

Table 1. CSV import fields
FieldExampleDescription
Required for cellular devices
modemtypeIMEIAlways set this value to IMEI using uppercase characters.
modemid123456789012347Set this value to the device’s IMEI number. Use only the first IMEI number with dual-SIM devices. The portal validates the IMEI value when processing the data row.
Required for Wi-Fi-only devices
serialABcd1235678The manufacturer’s case-sensitive serial number for the device.
modelVM1ASet this value to the device’s model. You need to make sure this is one of the names listed in Models.
Required fields
manufacturerGoogleSet this value to the device manufacturer’s name. You need to make sure this is one of the names listed in Manufacturers.
profiletypeZERO_TOUCHAlways set this value to ZERO_TOUCH using uppercase characters.
owner54321Set this value to the numeric ID of the customer you want to assign the device to. To find the ID for a customer, follow the steps in View customers (above).
Optional fields
phonenumber+1 (800) 555-0100Optionally, set this value to the telephone number of the device. You can use any format that makes sense for your organization.
ordernumberGOOG#123/ABC-123456Optionally, set this value to the order number for the purchase. You can use any format that makes sense for your organization.

Deregister devices

You'll need to deregister a customer's device before you can assign the same device to a different customer.

Single device

You can deregister one device at a time by selecting devices in the portal. To deregister a device, follow the steps below:

  1. Open the portal. You might need to sign in.
  2. Find the devices you want to deregister by following the steps in Find devices above.
  3. Locate the device in the Registered Devices table if there is more than one device in the results.
  4. Click Deregister in the device row.
  5. Click Deregister in the confirmation panel.

Multiple devices

You deregister customers' devices by uploading a CSV file. Use the CSV field format above and set the owner field to 0 (zero). Confirm that the CSV file you upload to the portal is smaller than 50 MB because that's the largest file the portal accepts. The following snippet shows an example CSV file to deregister two devices.

modemtype,modemid,manufacturer,profiletype,owner
IMEI,123456789012347,Google,ZERO_TOUCH,0
IMEI,123456789012354,Google,ZERO_TOUCH,0

To deregister a batch of devices, follow the steps below:

  1. Open the portal. You might need to sign in.
  2. Click cloud_upload Device Upload in the sidebar.
  3. Click file_upload Upload.
  4. Select your CSV file from the file picker.

After the file uploads, the portal processes the data rows. When processing finishes, the portal shows a notification with a link to an upload status page. You also receive an email summarizing the processing of your CSV data. Click the See details button in the email to open the status page for your CSV file. The status page lists any devices the portal didn't deregister with a reason for the error.

Export devices

To export a CSV file of your customers' devices, follow the steps below:

  1. Find the devices you want to export by following the steps in Find devices above.
  2. If your search found devices, click file_download Download.

The CSV file contains all your found devices, not just the result rows shown in the table. The export CSV file contains the following fields:

  • imei contains the GSM network identity number for the device.
  • serialnumber contains the manufacturer's serial number for the device. This might be empty if the serial number isn't recorded for the device.
  • manufacturer contains the device manufacturer’s name. This is one of the values listed in Manufacturer names.
  • model contains the manufacturer's name for the device model. This might be empty if the model isn't recorded for the device.
  • owner contains the numeric ID for the customer your organization assigned the device to. This matches the value listed in the My Customers page.
  • ownername contains the name of the customer your organization assigned the device to. This matches the value listed in the My Customers page.
  • reseller contains the numeric ID for the reseller (your organization or one of your vendors) that claimed the device.
  • resellername contains the name of the reseller (your organization or one of your vendors) that claimed the device.

The device export CSV file contains different columns than the device import CSV file. The snippet below shows the first lines from a typical device export CSV file:

imei,serialnumber,manufacturer,model,owner,ownername,reseller,resellername
"123456789012347","","Google","","123456789","ACME Wireless Inc.","54321","XYZ Corp"
"","ABcd1235678","Honeywell","VM1A","123456789","ACME Wireless Inc.","54321","XYZ Corp"

Dual-SIM devices

A dual-SIM device includes two discrete modems and has two IMEI numbers. Use the first hardware ID because zero-touch enrollment identifies devices by modem 1. If you mistakenly claim a device using another IMEI or MEID number, the portal shows a new, separate device. However, zero-touch enrollment doesn't provision the new device.

Vendors

You can use vendors to represent reseller partners in your dealer network, local operators within a global reseller network, or any organization that sells devices on your behalf. Vendors help you separate your users, customers, and devices:

  • Vendors you create can’t see your zero-touch enrollment account or each others’ accounts.
  • You can view your vendors’ customers and devices and you can deregister vendors’ devices. However, you can’t assign devices to your vendors’ customers.

Vendors appear and behave (in the portal and APIs) just as a reseller does—except that a vendor can't have other vendors.

View vendors

To see your organisation’s vendors:

  1. Open the portal. You might need to sign in.
  2. Click business Vendors in the sidebar.
  3. Look in the Vendors table to see your organization’s vendors.

If you don’t see Vendors in the sidebar, your organization is a vendor that’s already part of reseller network—check which zero-touch account you're using in the sidebar dropdown.

Create a vendor

You can set up a new vendor in the portal. After Google approves your new vendor, they can manage their customers and devices in their view of the portal. Before you add a new vendor, you need the following information.

  • A vendor name so you can identify the vendor in your portal. Give the vendor a short, recognizable, unique name so it’s easier to find in your portal.
  • Ask the vendor to supply at least one Google Account to be the owner. The owner can add and remove users, and other owners later. If the vendor needs help associating the account, send the instructions from Associate a Google Account above.

Before you start, check your account role to ensure that it's Owner. You need to be an account owner to add vendors. To create a vendor, follow the steps below:

  1. Open the portal. You might need to sign in.
  2. Click business Vendors in the sidebar.
  3. Click Create Vendor.
  4. Give the vendor a name.
  5. Set an owner for the vendor account in Manager email.
  6. Optionally, add comma-separated email addresses for other employees that need to access the portal.
  7. Check the details you've entered—you can't edit or delete a vendor after you create one.
  8. Click Add.

Your Android Platform Solutions Consultant might contact you to check that your reseller agreement covers your new vendor. Finally, the vendor receives an email that confirms the account is ready and notes the access your organization has to the customers and devices.

Portal users

Your organization manages the users that have access to the portal.

Your organization's portal users can be owners or admins. Owners share the same access as admins but can also add vendors and manage your organization's users. Table 2 compares the capabilities of the owner and admin roles:

Table 2. Role capabilities
Portal taskOwnerAdmin
Add, edit, and assign devices
Add customers
Add new vendors
Import and export CSV files
Add service accounts to get API access
Manage your organization's users

See your account's role

Follow the steps below to check your account's role:

  1. Open the portal. You might need to sign in.
  2. Click account_box Users in the sidebar.
  3. Look in the Role column to see your account's role.

Add team members

Before you start, check your account role to ensure that it's Owner. You need to be an account owner to add team members. Give portal access to new team members by following the steps below:

  1. Ask your team member to associate a Google Account with their corporate email. Your team member can follow the instructions in Associate a Google Account.
  2. Open the portal. You might need to sign in.
  3. Click account_box Users in the sidebar.
  4. Click add.
  5. Set Email address to the team member's corporate email.
  6. Select a Role.
  7. Click Add.

The portal doesn't notify your team member that they have access. You need to contact your team member and tell them about their new portal access.

Delete team members

Before you start, check your account role to ensure that it's Owner. You need to be an account owner to delete team members. To remove a team member's access to the portal, follow the steps below:

  1. Open the portal. You might need to sign in.
  2. Click account_box Users in the sidebar.
  3. Click Edit in the account row you want to delete.
  4. Check that the account is correct because the portal deletes the account without warning and you can't undo the action.
  5. Click Delete.

If you accidentally delete an account, re-add it by following the instructions in Add team members above.

Edit roles

Before you start, check your account role to ensure that it's Owner. You need to be an account owner to edit team members' roles. To change the role of a team member, follow the steps below:

  1. Open the portal. You might need to sign in.
  2. Click account_box Users in the sidebar.
  3. Click Edit for the account you want to edit.
  4. Select a Role.
  5. Click Add.

You might notice that you can't edit your own account role.

Portal languages

You can use the portal in one of the following languages:

American English, British English, Danish, Dutch, French, German, Italian, Japanese, Norwegian, Polish, Portuguese, Spanish, or Swedish.

To change to another language, update the preferred language in your Google Account. For more help, follow the instructions in Change language.