יצירה ועדכון של חברות (גרסה 3)

משאב Company ב-Cloud Talent Solution API מייצג חברה אחת. כל משרה שמשויכת לחברה הזו מתייחסת למודעה לפרסום משרה שנוצרה עבור משרה פתוחה בחברה. הוא מכיל מידע כמו שם החברה והכתובת, וגם שדות פנימיים שמקשרים את המשאב בשירות Cloud Talent Solution למסדי הנתונים הפנימיים שלכם.

יצירת חברה

כדי ליצור חברה, שולחים בקשת POST לנקודת הקצה companies ומציינים לפחות את שני שדות החובה. במאמר תחילת העבודה המהירה: יצירת חברות ומשרות מוסבר איך ליצור חברה.

Java

מידע נוסף על התקנה ויצירה של לקוח Cloud Talent Solution זמין במאמר בנושא ספריות לקוח של Cloud Talent Solution.


/** Create a company. */
public static Company createCompany(Company companyToBeCreated) throws IOException {
  try {
    CreateCompanyRequest createCompanyRequest =
        new CreateCompanyRequest().setCompany(companyToBeCreated);
    Company companyCreated =
        talentSolutionClient
            .projects()
            .companies()
            .create(DEFAULT_PROJECT_ID, createCompanyRequest)
            .execute();
    System.out.println("Company created: " + companyCreated);
    return companyCreated;
  } catch (IOException e) {
    System.out.println("Got exception while creating company");
    throw e;
  }
}

Python

מידע נוסף על התקנה ויצירה של לקוח Cloud Talent Solution זמין במאמר בנושא ספריות לקוח של Cloud Talent Solution.

def create_company(client_service, company_to_be_created):
    try:
        request = {"company": company_to_be_created}
        company_created = (
            client_service.projects()
            .companies()
            .create(parent=parent, body=request)
            .execute()
        )
        print("Company created: %s" % company_created)
        return company_created
    except Error as e:
        print("Got exception while creating company")
        raise e

Go

מידע נוסף על התקנה ויצירה של לקוח Cloud Talent Solution זמין במאמר בנושא ספריות לקוח של Cloud Talent Solution.


// createCompany creates a company as given.
func createCompany(w io.Writer, projectID string, companyToCreate *talent.Company) (*talent.Company, error) {
	ctx := context.Background()

	client, err := google.DefaultClient(ctx, talent.CloudPlatformScope)
	if err != nil {
		return nil, fmt.Errorf("google.DefaultClient: %w", err)
	}
	// Create the jobs service client.
	service, err := talent.New(client)
	if err != nil {
		return nil, fmt.Errorf("talent.New: %w", err)
	}

	parent := "projects/" + projectID
	req := &talent.CreateCompanyRequest{
		Company: companyToCreate,
	}
	company, err := service.Projects.Companies.Create(parent, req).Do()
	if err != nil {
		return nil, fmt.Errorf("failed to create company %q: %w", companyToCreate.DisplayName, err)
	}

	return company, nil
}

שדות חובה

חובה למלא את השדות הבאים בבקשות ליצירה או לעדכון:

  • ‫displayName: שם המעסיק שמוצג עם המשרה, לדוגמה, 'Google LLC'.

  • ‫externalId: המזהה הפנימי של החברה. בשדה הזה אפשר למפות את המזהים הפנימיים שלכם לחברה במערכת של Google. אם לחברה אין מזהה פנימי נפרד, צריך להגדיר בשדה הזה את אותו הערך שמוגדר במאפיין displayName.

שדות בשימוש נפוץ

  • ‫headquartersAddress: כתובת הרחוב של המשרדים הראשיים של החברה, שיכולה להיות שונה ממיקום העבודה. ‫Cloud Talent Solution מקבל רק מיקום אחד של מטה לכל חברה. השירות מנסה לאתר את הכתובת במיקום גיאוגרפי, ומזין מיקום ספציפי יותר ב-derivedInfo.headquartersLocation (שהוא פלט בלבד) אם אפשר.

  • ‫size: ערך של קטגוריה שמייצג את גודל החברה מבחינת מספר העובדים, מ-MINI עד GIANT. לפרטים נוספים על סוגי הנתונים וההגדרות שלהם, אפשר לעיין במפרט של השיטה ב-size.

  • ‫eeoText: מחרוזת שמכילה את הטקסט של כתב הוויתור המשפטי בנושא שוויון הזדמנויות בתעסוקה, שיוצג בכל המשרות של החברה הזו.

  • ‫keywordSearchableJobCustomAttributes: מציין אילו customAttributes במשרות של החברה הזו צריכים להיכלל באינדקס ולהיות זמינים לחיפוש לפי מילת מפתח כללית.

עדכון פרטי חברה

כדי לעדכן חברה, שולחים בקשת PATCH לנקודת הקצה הבאה:

 PATCH https://jobs.googleapis.com/v3/COMPANY_NAME 

כאשר COMPANY_NAME הוא הערך של השדה name עבור החברה. ‫name הוא המזהה הייחודי של החברה שמוחזר בזמן היצירה וגם על ידי בקשות company.get ו-list.

גוף הבקשה חייב להכיל את כל המשאב, כולל שדות שלא מתעדכנים. אפשר להגדיר את השדות האלה בגרסה ברמת updateMask. אם השדות מוגדרים ב-updateMask, רק השדות האלה מתעדכנים והמערכת מתעלמת מעדכונים של שדות אחרים. אם לא מוגדר updateMask, כל השדות מתעדכנים.

Java

מידע נוסף על התקנה ויצירה של לקוח Cloud Talent Solution זמין במאמר בנושא ספריות לקוח של Cloud Talent Solution.


/** Updates a company. */
public static Company updateCompany(String companyName, Company companyToBeUpdated)
    throws IOException {
  try {
    UpdateCompanyRequest updateCompanyRequest =
        new UpdateCompanyRequest().setCompany(companyToBeUpdated);

    Company companyUpdated =
        talentSolutionClient
            .projects()
            .companies()
            .patch(companyName, updateCompanyRequest)
            .execute();

    System.out.println("Company updated: " + companyUpdated);
    return companyUpdated;
  } catch (IOException e) {
    System.out.println("Got exception while updating company");
    throw e;
  }
}

Python

מידע נוסף על התקנה ויצירה של לקוח Cloud Talent Solution זמין במאמר בנושא ספריות לקוח של Cloud Talent Solution.

def update_company(client_service, company_name, company_to_be_updated):
    try:
        request = {"company": company_to_be_updated}
        company_updated = (
            client_service.projects()
            .companies()
            .patch(name=company_name, body=request)
            .execute()
        )
        print("Company updated: %s" % company_updated)
        return company_updated
    except Error as e:
        print("Got exception while updating company")
        raise e

Go

מידע נוסף על התקנה ויצירה של לקוח Cloud Talent Solution זמין במאמר בנושא ספריות לקוח של Cloud Talent Solution.


// updateCompany update a company with all fields.
func updateCompany(w io.Writer, name string, companyToUpdate *talent.Company) (*talent.Company, error) {
	ctx := context.Background()

	client, err := google.DefaultClient(ctx, talent.CloudPlatformScope)
	if err != nil {
		return nil, fmt.Errorf("google.DefaultClient: %w", err)
	}
	// Create the jobs service client.
	service, err := talent.New(client)
	if err != nil {
		return nil, fmt.Errorf("talent.New: %w", err)
	}

	updateCompanyRequest := &talent.UpdateCompanyRequest{
		Company: companyToUpdate,
	}
	company, err := service.Projects.Companies.Patch(name, updateCompanyRequest).Do()
	if err != nil {
		return nil, fmt.Errorf("failed to update company %q: %w", name, err)
	}

	return company, nil
}

עדכון פרטי החברה עם updateMask

Java

מידע נוסף על התקנה ויצירה של לקוח Cloud Talent Solution זמין במאמר בנושא ספריות לקוח של Cloud Talent Solution.


/** Updates a company. */
public static Company updateCompanyWithFieldMask(
    String companyName, String fieldMask, Company companyToBeUpdated) throws IOException {
  try {
    // String foo = String.format("?updateCompanyFields=%s",fieldMask);
    UpdateCompanyRequest updateCompanyRequest =
        new UpdateCompanyRequest().setUpdateMask(fieldMask).setCompany(companyToBeUpdated);

    Company companyUpdated =
        talentSolutionClient
            .projects()
            .companies()
            .patch(companyName, updateCompanyRequest)
            .execute();

    System.out.println("Company updated: " + companyUpdated);
    return companyUpdated;
  } catch (IOException e) {
    System.out.println("Got exception while updating company");
    throw e;
  }
}

Python

מידע נוסף על התקנה ויצירה של לקוח Cloud Talent Solution זמין במאמר בנושא ספריות לקוח של Cloud Talent Solution.

def update_company_with_field_mask(
    client_service, company_name, company_to_be_updated, field_mask
):
    try:
        request = {"company": company_to_be_updated, "update_mask": field_mask}
        company_updated = (
            client_service.projects()
            .companies()
            .patch(name=company_name, body=request)
            .execute()
        )
        print("Company updated: %s" % company_updated)
        return company_updated
    except Error as e:
        print("Got exception while updating company with field mask")
        raise e

Go

מידע נוסף על התקנה ויצירה של לקוח Cloud Talent Solution זמין במאמר בנושא ספריות לקוח של Cloud Talent Solution.


// updateCompanyWithMask updates a company with specific fields.
// mask is a comma separated list of top-level fields of talent.Company.
func updateCompanyWithMask(w io.Writer, name string, mask string, companyToUpdate *talent.Company) (*talent.Company, error) {
	ctx := context.Background()

	client, err := google.DefaultClient(ctx, talent.CloudPlatformScope)
	if err != nil {
		return nil, fmt.Errorf("google.DefaultClient: %w", err)
	}
	// Create the jobs service client.
	service, err := talent.New(client)
	if err != nil {
		return nil, fmt.Errorf("talent.New: %w", err)
	}

	req := &talent.UpdateCompanyRequest{
		Company:    companyToUpdate,
		UpdateMask: mask,
	}
	company, err := service.Projects.Companies.Patch(name, req).Do()
	if err != nil {
		return nil, fmt.Errorf("failed to update company %q with mask %q: %w", name, mask, err)
	}

	return company, nil
}

שיטות מומלצות

חברות סודיות

אם רוצים לפרסם משרה סודית, מומלץ ליצור חברה נפרדת שכוללת את השדות של החברה המקורית, אבל מסתירה את השדות displayName, externalId ושדות מזהים אחרים.

במקרים שבהם המעסיק הסופי צריך להיות אנונימי (לדוגמה, בתרחיש השימוש של סוכנות כוח אדם), מומלץ להגדיר את externalId ואת displayName לערכים אקראיים אבל ייחודיים.