# Enterprise Apps Reseller API . customers

## Instance Methods

Get a customer account.

Order a new customer's account.

Update a customer account's settings. This method supports patch semantics.

Update a customer account's settings.

### Method Details

`get(customerId)`

    Get a customer account.

    Args:
      customerId: string, Either the customer's primary domain name or the customer's unique identifier. If using the domain name, we do not recommend using a customerId as a key for persistent data. If the domain name for a customerId is changed, the Google system automatically updates. (required)

    Returns:
      An object of the form:

        { # JSON template for a customer.
          "customerDomain": "A String", # The customer's primary domain name string. customerDomain is required when creating a new customer. Do not include the www prefix in the domain when adding a customer.
          "customerDomainVerified": True or False, # Whether the customer's primary domain has been verified.
          "alternateEmail": "A String", # Like the "Customer email" in the reseller tools, this email is the secondary contact used if something happens to the customer's service such as service outage or a security issue. This property is required when creating a new customer and should not use the same domain as customerDomain.
          "kind": "reseller#customer", # Identifies the resource as a customer. Value: reseller#customer
          "resourceUiUrl": "A String", # URL to customer's Admin console dashboard. The read-only URL is generated by the API service. This is used if your client application requires the customer to complete a task in the Admin console.
          "phoneNumber": "A String", # Customer contact phone number. This can be continuous numbers, with spaces, etc. But it must be a real phone number and not, for example, "123". See phone  local format conventions.
          "postalAddress": { # JSON template for address of a customer. # A customer's address information. Each field has a limit of 255 charcters.
            "kind": "customers#address", # Identifies the resource as a customer address. Value: customers#address
            "organizationName": "A String", # The company or company division name. This is required.
            "countryCode": "A String", # For countryCode information, see the ISO 3166 country code elements. Verify that country is approved for resale of Google products. This property is required when creating a new customer.
            "locality": "A String", # An example of a locality value is the city of San Francisco.
            "region": "A String", # An example of a region value is CA for the state of California.
            "addressLine2": "A String", # Line 2 of the address.
            "addressLine3": "A String", # Line 3 of the address.
            "contactName": "A String", # The customer contact's name. This is required.
            "addressLine1": "A String", # A customer's physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional.
            "postalCode": "A String", # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer.
          },
          "customerId": "A String", # This property will always be returned in a response as the unique identifier generated by Google. In a request, this property can be either the primary domain or the unique identifier generated by Google.
        }

`insert(body, customerAuthToken=None)`

    Order a new customer's account.

    Args:
      body: object, The request body. (required)
        The object takes the form of:

    { # JSON template for a customer.
        "customerDomain": "A String", # The customer's primary domain name string. customerDomain is required when creating a new customer. Do not include the www prefix in the domain when adding a customer.
        "customerDomainVerified": True or False, # Whether the customer's primary domain has been verified.
        "alternateEmail": "A String", # Like the "Customer email" in the reseller tools, this email is the secondary contact used if something happens to the customer's service such as service outage or a security issue. This property is required when creating a new customer and should not use the same domain as customerDomain.
        "kind": "reseller#customer", # Identifies the resource as a customer. Value: reseller#customer
        "resourceUiUrl": "A String", # URL to customer's Admin console dashboard. The read-only URL is generated by the API service. This is used if your client application requires the customer to complete a task in the Admin console.
        "phoneNumber": "A String", # Customer contact phone number. This can be continuous numbers, with spaces, etc. But it must be a real phone number and not, for example, "123". See phone  local format conventions.
        "postalAddress": { # JSON template for address of a customer. # A customer's address information. Each field has a limit of 255 charcters.
          "kind": "customers#address", # Identifies the resource as a customer address. Value: customers#address
          "organizationName": "A String", # The company or company division name. This is required.
          "countryCode": "A String", # For countryCode information, see the ISO 3166 country code elements. Verify that country is approved for resale of Google products. This property is required when creating a new customer.
          "locality": "A String", # An example of a locality value is the city of San Francisco.
          "region": "A String", # An example of a region value is CA for the state of California.
          "addressLine2": "A String", # Line 2 of the address.
          "addressLine3": "A String", # Line 3 of the address.
          "contactName": "A String", # The customer contact's name. This is required.
          "addressLine1": "A String", # A customer's physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional.
          "postalCode": "A String", # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer.
        },
        "customerId": "A String", # This property will always be returned in a response as the unique identifier generated by Google. In a request, this property can be either the primary domain or the unique identifier generated by Google.
      }

      customerAuthToken: string, The customerAuthToken query string is required when creating a resold account that transfers a direct customer's subscription or transfers another reseller customer's subscription to your reseller management. This is a hexadecimal authentication token needed to complete the subscription transfer. For more information, see the administrator help center.

    Returns:
      An object of the form:

        { # JSON template for a customer.
          "customerDomain": "A String", # The customer's primary domain name string. customerDomain is required when creating a new customer. Do not include the www prefix in the domain when adding a customer.
          "customerDomainVerified": True or False, # Whether the customer's primary domain has been verified.
          "alternateEmail": "A String", # Like the "Customer email" in the reseller tools, this email is the secondary contact used if something happens to the customer's service such as service outage or a security issue. This property is required when creating a new customer and should not use the same domain as customerDomain.
          "kind": "reseller#customer", # Identifies the resource as a customer. Value: reseller#customer
          "resourceUiUrl": "A String", # URL to customer's Admin console dashboard. The read-only URL is generated by the API service. This is used if your client application requires the customer to complete a task in the Admin console.
          "phoneNumber": "A String", # Customer contact phone number. This can be continuous numbers, with spaces, etc. But it must be a real phone number and not, for example, "123". See phone  local format conventions.
          "postalAddress": { # JSON template for address of a customer. # A customer's address information. Each field has a limit of 255 charcters.
            "kind": "customers#address", # Identifies the resource as a customer address. Value: customers#address
            "organizationName": "A String", # The company or company division name. This is required.
            "countryCode": "A String", # For countryCode information, see the ISO 3166 country code elements. Verify that country is approved for resale of Google products. This property is required when creating a new customer.
            "locality": "A String", # An example of a locality value is the city of San Francisco.
            "region": "A String", # An example of a region value is CA for the state of California.
            "addressLine2": "A String", # Line 2 of the address.
            "addressLine3": "A String", # Line 3 of the address.
            "contactName": "A String", # The customer contact's name. This is required.
            "addressLine1": "A String", # A customer's physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional.
            "postalCode": "A String", # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer.
          },
          "customerId": "A String", # This property will always be returned in a response as the unique identifier generated by Google. In a request, this property can be either the primary domain or the unique identifier generated by Google.
        }

`patch(customerId, body)`

    Update a customer account's settings. This method supports patch semantics.

    Args:
      customerId: string, Either the customer's primary domain name or the customer's unique identifier. If using the domain name, we do not recommend using a customerId as a key for persistent data. If the domain name for a customerId is changed, the Google system automatically updates. (required)
      body: object, The request body. (required)
        The object takes the form of:

    { # JSON template for a customer.
        "customerDomain": "A String", # The customer's primary domain name string. customerDomain is required when creating a new customer. Do not include the www prefix in the domain when adding a customer.
        "customerDomainVerified": True or False, # Whether the customer's primary domain has been verified.
        "alternateEmail": "A String", # Like the "Customer email" in the reseller tools, this email is the secondary contact used if something happens to the customer's service such as service outage or a security issue. This property is required when creating a new customer and should not use the same domain as customerDomain.
        "kind": "reseller#customer", # Identifies the resource as a customer. Value: reseller#customer
        "resourceUiUrl": "A String", # URL to customer's Admin console dashboard. The read-only URL is generated by the API service. This is used if your client application requires the customer to complete a task in the Admin console.
        "phoneNumber": "A String", # Customer contact phone number. This can be continuous numbers, with spaces, etc. But it must be a real phone number and not, for example, "123". See phone  local format conventions.
        "postalAddress": { # JSON template for address of a customer. # A customer's address information. Each field has a limit of 255 charcters.
          "kind": "customers#address", # Identifies the resource as a customer address. Value: customers#address
          "organizationName": "A String", # The company or company division name. This is required.
          "countryCode": "A String", # For countryCode information, see the ISO 3166 country code elements. Verify that country is approved for resale of Google products. This property is required when creating a new customer.
          "locality": "A String", # An example of a locality value is the city of San Francisco.
          "region": "A String", # An example of a region value is CA for the state of California.
          "addressLine2": "A String", # Line 2 of the address.
          "addressLine3": "A String", # Line 3 of the address.
          "contactName": "A String", # The customer contact's name. This is required.
          "addressLine1": "A String", # A customer's physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional.
          "postalCode": "A String", # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer.
        },
        "customerId": "A String", # This property will always be returned in a response as the unique identifier generated by Google. In a request, this property can be either the primary domain or the unique identifier generated by Google.
      }

    Returns:
      An object of the form:

        { # JSON template for a customer.
          "customerDomain": "A String", # The customer's primary domain name string. customerDomain is required when creating a new customer. Do not include the www prefix in the domain when adding a customer.
          "customerDomainVerified": True or False, # Whether the customer's primary domain has been verified.
          "alternateEmail": "A String", # Like the "Customer email" in the reseller tools, this email is the secondary contact used if something happens to the customer's service such as service outage or a security issue. This property is required when creating a new customer and should not use the same domain as customerDomain.
          "kind": "reseller#customer", # Identifies the resource as a customer. Value: reseller#customer
          "resourceUiUrl": "A String", # URL to customer's Admin console dashboard. The read-only URL is generated by the API service. This is used if your client application requires the customer to complete a task in the Admin console.
          "phoneNumber": "A String", # Customer contact phone number. This can be continuous numbers, with spaces, etc. But it must be a real phone number and not, for example, "123". See phone  local format conventions.
          "postalAddress": { # JSON template for address of a customer. # A customer's address information. Each field has a limit of 255 charcters.
            "kind": "customers#address", # Identifies the resource as a customer address. Value: customers#address
            "organizationName": "A String", # The company or company division name. This is required.
            "countryCode": "A String", # For countryCode information, see the ISO 3166 country code elements. Verify that country is approved for resale of Google products. This property is required when creating a new customer.
            "locality": "A String", # An example of a locality value is the city of San Francisco.
            "region": "A String", # An example of a region value is CA for the state of California.
            "addressLine2": "A String", # Line 2 of the address.
            "addressLine3": "A String", # Line 3 of the address.
            "contactName": "A String", # The customer contact's name. This is required.
            "addressLine1": "A String", # A customer's physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional.
            "postalCode": "A String", # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer.
          },
          "customerId": "A String", # This property will always be returned in a response as the unique identifier generated by Google. In a request, this property can be either the primary domain or the unique identifier generated by Google.
        }

`update(customerId, body)`

    Update a customer account's settings.

    Args:
      customerId: string, Either the customer's primary domain name or the customer's unique identifier. If using the domain name, we do not recommend using a customerId as a key for persistent data. If the domain name for a customerId is changed, the Google system automatically updates. (required)
      body: object, The request body. (required)
        The object takes the form of:

    { # JSON template for a customer.
        "customerDomain": "A String", # The customer's primary domain name string. customerDomain is required when creating a new customer. Do not include the www prefix in the domain when adding a customer.
        "customerDomainVerified": True or False, # Whether the customer's primary domain has been verified.
        "alternateEmail": "A String", # Like the "Customer email" in the reseller tools, this email is the secondary contact used if something happens to the customer's service such as service outage or a security issue. This property is required when creating a new customer and should not use the same domain as customerDomain.
        "kind": "reseller#customer", # Identifies the resource as a customer. Value: reseller#customer
        "resourceUiUrl": "A String", # URL to customer's Admin console dashboard. The read-only URL is generated by the API service. This is used if your client application requires the customer to complete a task in the Admin console.
        "phoneNumber": "A String", # Customer contact phone number. This can be continuous numbers, with spaces, etc. But it must be a real phone number and not, for example, "123". See phone  local format conventions.
        "postalAddress": { # JSON template for address of a customer. # A customer's address information. Each field has a limit of 255 charcters.
          "kind": "customers#address", # Identifies the resource as a customer address. Value: customers#address
          "organizationName": "A String", # The company or company division name. This is required.
          "countryCode": "A String", # For countryCode information, see the ISO 3166 country code elements. Verify that country is approved for resale of Google products. This property is required when creating a new customer.
          "locality": "A String", # An example of a locality value is the city of San Francisco.
          "region": "A String", # An example of a region value is CA for the state of California.
          "addressLine2": "A String", # Line 2 of the address.
          "addressLine3": "A String", # Line 3 of the address.
          "contactName": "A String", # The customer contact's name. This is required.
          "addressLine1": "A String", # A customer's physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional.
          "postalCode": "A String", # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer.
        },
        "customerId": "A String", # This property will always be returned in a response as the unique identifier generated by Google. In a request, this property can be either the primary domain or the unique identifier generated by Google.
      }

    Returns:
      An object of the form:

        { # JSON template for a customer.
          "customerDomain": "A String", # The customer's primary domain name string. customerDomain is required when creating a new customer. Do not include the www prefix in the domain when adding a customer.
          "customerDomainVerified": True or False, # Whether the customer's primary domain has been verified.
          "alternateEmail": "A String", # Like the "Customer email" in the reseller tools, this email is the secondary contact used if something happens to the customer's service such as service outage or a security issue. This property is required when creating a new customer and should not use the same domain as customerDomain.
          "kind": "reseller#customer", # Identifies the resource as a customer. Value: reseller#customer
          "resourceUiUrl": "A String", # URL to customer's Admin console dashboard. The read-only URL is generated by the API service. This is used if your client application requires the customer to complete a task in the Admin console.
          "phoneNumber": "A String", # Customer contact phone number. This can be continuous numbers, with spaces, etc. But it must be a real phone number and not, for example, "123". See phone  local format conventions.
          "postalAddress": { # JSON template for address of a customer. # A customer's address information. Each field has a limit of 255 charcters.
            "kind": "customers#address", # Identifies the resource as a customer address. Value: customers#address
            "organizationName": "A String", # The company or company division name. This is required.
            "countryCode": "A String", # For countryCode information, see the ISO 3166 country code elements. Verify that country is approved for resale of Google products. This property is required when creating a new customer.
            "locality": "A String", # An example of a locality value is the city of San Francisco.
            "region": "A String", # An example of a region value is CA for the state of California.
            "addressLine2": "A String", # Line 2 of the address.
            "addressLine3": "A String", # Line 3 of the address.
            "contactName": "A String", # The customer contact's name. This is required.
            "addressLine1": "A String", # A customer's physical address. An address can be composed of one to three lines. The addressline2 and addressLine3 are optional.
            "postalCode": "A String", # A postalCode example is a postal zip code such as 94043. This property is required when creating a new customer.
          },
          "customerId": "A String", # This property will always be returned in a response as the unique identifier generated by Google. In a request, this property can be either the primary domain or the unique identifier generated by Google.
        }