# REST Resource: partners.opportunities

- [Resource: Opportunity](https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#Opportunity)
  - [JSON representation](https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#Opportunity.SCHEMA_REPRESENTATION)
- [ContactDetails](https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#ContactDetails)
  - [JSON representation](https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#ContactDetails.SCHEMA_REPRESENTATION)
- [SourceSystem](https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#SourceSystem)
- [SalesStage](https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#SalesStage)
- [QualificationState](https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#QualificationState)
- [DecisionPhase](https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#DecisionPhase)
- [Methods](https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#METHODS_SUMMARY)

## Resource: Opportunity

Resource representing a Opportunity for a Google Cloud Partner.

| JSON representation |
|---|
| ``` { "name": string, "lead": string, "owner": { object (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#ContactDetails`) }, "notes": string, "nextSteps": string, "dealSize": number, "dealCurrencyCode": string, "closeDate": { object (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/Date`) }, "sourceSystem": enum (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#SourceSystem`), "salesStage": enum (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#SalesStage`), "winProbability": string, "productFamily": enum (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/ProductFamily`), "termMonths": string, "customer": { object (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/Customer`) }, "qualificationState": enum (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#QualificationState`), "externalSystemId": string, "createDate": { object (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/Date`) }, "submitDate": { object (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/Date`) }, "isConfidential": boolean, "decisionPhase": enum (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#DecisionPhase`) } ``` |

| Fields ||
|---|---|
| `name` | `string` Format: partners/{partner_id}/opportunities/{opportunity_id} |
| `lead` | `string` Output only. Lead corresponding to Opportunity. |
| `owner` | ``object (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#ContactDetails`)`` Output only. Opportunity owner contact details. |
| `notes` | `string` Notes on Opportunity. |
| `nextSteps` | `string` Next steps need to be taken on Opportunity. |
| `dealSize` | `number` Optional. Total deal size Amount in value. |
| `dealCurrencyCode` | `string` Output only. Currency of deal size. |
| `closeDate` | ``object (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/Date`)`` Optional. Close date assigned to Opportunity. |
| `sourceSystem` | ``enum (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#SourceSystem`)`` Output only. Source of Opportunity. |
| `salesStage` | ``enum (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#SalesStage`)`` Sales stage of Opportunity. |
| `winProbability` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. Probability percentage of winning the Opportunity. |
| `productFamily` | ``enum (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/ProductFamily`)`` Output only. Product Family associated with Opportunity. |
| `termMonths` | `string (https://developers.google.com/discovery/v1/type-format format)` Optional. Term in months of Opportunity. |
| `customer` | ``object (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/Customer`)`` Output only. Represents Customer Account. |
| `qualificationState` | ``enum (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#QualificationState`)`` Represents Qualification State. |
| `externalSystemId` | `string` External ID of Opportunity. |
| `createDate` | ``object (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/Date`)`` Output only. Created date. |
| `submitDate` | ``object (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/Date`)`` Output only. Submitted date. |
| `isConfidential` | `boolean` Optional. Indicates whether the Opportunity is confidential. |
| `decisionPhase` | ``enum (`https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities#DecisionPhase`)`` Optional. Decision Phase of Opportunity. |

## ContactDetails

Represents Contact Details.

| JSON representation |
|---|
| ``` { "givenName": string, "familyName": string, "email": string, "phone": string } ``` |

| Fields ||
|---|---|
| `givenName` | `string` Given name of Contact. |
| `familyName` | `string` Family name of Contact. |
| `email` | `string` Primary Email of Contact. |
| `phone` | `string` Primary Phone of Contact. |

## SourceSystem

Represents the Source System of Opportunity.

| Enums ||
|---|---|
| `SOURCE_SYSTEM_UNSPECIFIED` | None specified. |
| `SOURCE_SYSTEM_PARTNER` | Partner as Source. |
| `SOURCE_SYSTEM_GOOGLE` | Google as Source System. |
| `SOURCE_SYSTEM_GOOGLE_BDR` | Sourced by Google BDR(Buyside Display Reporting) Team. |
| `SOURCE_SYSTEM_GOOGLE_PROGRAMMATIC` | Sourced Programmatically, loaded by DataOps Team. |

## SalesStage

Represents the Sales Stage of Opportunity.

| Enums ||
|---|---|
| `SALES_STAGE_UNSPECIFIED` | None specified. |
| `SALES_STAGE_QUALIFY` | Sales is in Qualify stage. |
| `SALES_STAGE_REFINE` | Sales is in Refine Stage. |
| `SALES_STAGE_TECH_EVAL_SOLUTION_DEV` | Sales is in Tech Evaluation/Solution Dev stage. |
| `SALES_STAGE_PROPOSAL_NEGOTIATION` | Sales is in Proposal/Negotiation stage. |
| `SALES_STAGE_MIGRATION_IMPLEMENTATION` | Sales is in Migration Implementation stage. |
| `SALES_STAGE_CLOSED_LOST` | Sales is in Closed Lost stage. |
| `SALES_STAGE_CLOSED_ADMIN` | Sales is Closed by admin. |

## QualificationState

Represents the Qualification State of Opportunity.

| Enums ||
|---|---|
| `QUALIFICATION_STATE_UNSPECIFIED` | None specified. |
| `QUALIFICATION_STATE_APPROVED` | Opportunity Approved. |
| `QUALIFICATION_STATE_REJECTED` | Opportunity Rejected. |

## DecisionPhase

Represents the Decision Phase of Opportunity.

| Enums ||
|---|---|
| `DECISION_PHASE_UNSPECIFIED` | None specified. |
| `INITIAL_RESEARCH_AND_INFO_GATHERING` | Initial research and information gathering. |
| `CURRENTLY_IN_TRIAL_OR_LOOKING_TO_TRIAL_OR_PILOT` | Currently in-trial or looking to trial/pilot. |
| `FINAL_DECISION` | Final decision. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities/get` | Gets an Opportunity. |
| ### `https://developers.google.com/cloud-crm-partners/reference/rest/v1/partners.opportunities/patch` | Updates an Opportunity for a Partner. |