Partager via


Recommendation

The identity of the resourceName are recs and recRequests . Currently, these two resources captures recommendation requests the member asks. After approval, the members will have the option to set the rec to visible on their own profiles. A recommendation is shown on the member's profile page under the Recommendations section. An recs ACTION is also available and it involves reordering of the recommendation on the profile page. See examples below:

RecRequests Activity - Writing a recommendation

{
  "owner": "urn:li:person:Ylpq-RobP9",
  "owner~": {
    "firstName": {
      "localized": {
        "en_US": "John"
      },
      "preferredLocale": {
        "country": "US",
        "language": "en"
      }
    },
    "lastName": {
      "localized": {
        "en_US": "Smith"
      },
      "preferredLocale": {
        "country": "US",
        "language": "en"
      }
    },
    "headline": {
      "localized": {
        "en_US": "Software Engineer"
      },
      "preferredLocale": {
        "country": "US",
        "language": "en"
      }
    }
  },
  "configVersion": 1,
  "method": "BATCH_CREATE",
  "activity": {
    "requester": "urn:li:person:Ylpq-RobP9",
    "previousRecommendation": "urn:li:recommendation:(urn:li:person:5Lvu9VVW1m,335004)",
    "notification": {
      "subject": "Inspector, can you update this recommendation?",
      "message": "change this \n\n\"John needs this recommendation! He is AMAZING!\""
    },
    "requestee": "urn:li:person:5Lvu9VVW1m",
    "requesteeEntity": "urn:li:position:(urn:li:person:5Lvu9VVW1m,38208463)",
    "requesterEntity": "urn:li:position:(urn:li:person:Ylpq-RobP9,47021965)",
    "relationship": "RECOMMENDER_REPORTED_TO_RECOMMENDEE"
  },
  "actor~": {
    "firstName": {
      "localized": {
        "en_US": "John"
      },
      "preferredLocale": {
        "country": "US",
        "language": "en"
      }
    },
    "lastName": {
      "localized": {
        "en_US": "Smith"
      },
      "preferredLocale": {
        "country": "US",
        "language": "en"
      }
    },
    "headline": {
      "localized": {
        "en_US": "Software Engineer"
      },
      "preferredLocale": {
        "country": "US",
        "language": "en"
      }
    }
  },
  "resourceName": "recRequests",
  "resourceUri": "/recRequests/urn:li:recommendationRequest:(urn:li:person:Ylpq-RobP9,266824)",
  "actor": "urn:li:person:Ylpq-RobP9",
  "processedAt": 1486517118769,
  "capturedAt": 1486517091202,
  "processedActivity": {
    "requester": "urn:li:person:Ylpq-RobP9",
    "notification": {
      "subject": "Inspector, can you update this recommendation?",
      "message": "change this \n\n\"John needs this recommendation! He is AMAZING!\""
    },
    "requestee": "urn:li:person:5Lvu9VVW1m",
    "requester~": {
      "lastName": {
        "localized": {
          "en_US": "Smith"
        },
        "preferredLocale": {
          "country": "US",
          "language": "en"
        }
      },
      "firstName": {
        "localized": {
          "en_US": "John"
        },
        "preferredLocale": {
          "country": "US",
          "language": "en"
        }
      },
      "headline": {
        "localized": {
          "en_US": "Software Engineer"
        },
        "preferredLocale": {
          "country": "US",
          "language": "en"
        }
      }
    },
    "requesteeEntity": "urn:li:position:(urn:li:person:5Lvu9VVW1m,38208463)",
    "requestee~": {
      "lastName": {
        "localized": {
          "en_US": "Smith"
        },
        "preferredLocale": {
          "country": "US",
          "language": "en"
        }
      },
      "firstName": {
        "localized": {
          "en_US": "Inspector"
        },
        "preferredLocale": {
          "country": "US",
          "language": "en"
        }
      }"headline": {
        "localized": {
          "en_US": "Test Engineer at LinkedIn"
        },
        "preferredLocale": {
          "country": "US",
          "language": "en"
        }
      }
    },
    "requesterEntity": "urn:li:position:(urn:li:person:Ylpq-RobP9,47021965)",
    "relationship": "RECOMMENDER_REPORTED_TO_RECOMMENDEE"
  },
  "id": 7963,
  "activityId": "12356788990000"
}

Recs Activity - Displaying the recommendation on profile

{
    "activity": {
        "status": "VISIBLE"
    }, 
    "activityId": "12356788990000", 
    "actor": "urn:li:person:Ylpq-RobP9", 
    "actor~": {
        "firstName": {
            "localized": {
                "en_US": "John"
            }, 
            "preferredLocale": {
                "country": "US", 
                "language": "en"
            }
        }, 
        "headline": {
            "localized": {
                "en_US": "Software Engineer"
            }, 
            "preferredLocale": {
                "country": "US", 
                "language": "en"
            }
        }, 
        "lastName": {
            "localized": {
                "en_US": "Smith"
            }, 
            "preferredLocale": {
                "country": "US", 
                "language": "en"
            }
        }
    }, 
    "capturedAt": 1489515453144, 
    "configVersion": 3, 
    "id": 10660, 
    "method": "PARTIAL_UPDATE", 
    "owner": "urn:li:person:Ylpq-RobP9", 
    "owner~": {
        "firstName": {
            "localized": {
                "en_US": "John"
            }, 
            "preferredLocale": {
                "country": "US", 
                "language": "en"
            }
        }, 
        "headline": {
            "localized": {
                "en_US": "Software Engineer"
            }, 
            "preferredLocale": {
                "country": "US", 
                "language": "en"
            }
        }, 
        "lastName": {
            "localized": {
                "en_US": "Smith"
            }, 
            "preferredLocale": {
                "country": "US", 
                "language": "en"
            }
        }
    }, 
    "processedActivity": {
        "status": "VISIBLE"
    }, 
    "processedAt": 1489515468590, 
    "resourceName": "recs", 
    "resourceUri": "/recs/urn:li:recommendation:(urn:li:person:5Lvu9VVW1m,335644)"
}

Recs Activity - ACTION reorder of a recommendation

{
    "activity": {
        "moveRecommendation": "urn:li:recommendation:(urn:li:person:5Lvu9VVW1m,335014)", 
        "recommendeeEntity": "urn:li:position:(urn:li:person:Ylpq-RobP9,47050422)"
    }, 
    "activityId": "12356788990000", 
    "actor": "urn:li:person:Ylpq-RobP9", 
    "actor~": {
        "firstName": {
            "localized": {
                "en_US": "John"
            }, 
            "preferredLocale": {
                "country": "US", 
                "language": "en"
            }
        }, 
        "headline": {
            "localized": {
                "en_US": "Software Engineer"
            }, 
            "preferredLocale": {
                "country": "US", 
                "language": "en"
            }
        }, 
        "lastName": {
            "localized": {
                "en_US": "Smith"
            }, 
            "preferredLocale": {
                "country": "US", 
                "language": "en"
            }
        }
    }, 
    "capturedAt": 1487024072057, 
    "configVersion": 4, 
    "id": 8771, 
    "method": "ACTION", 
    "owner": "urn:li:person:Ylpq-RobP9", 
    "owner~": {
        "firstName": {
            "localized": {
                "en_US": "John"
            }, 
            "preferredLocale": {
                "country": "US", 
                "language": "en"
            }
        }, 
        "headline": {
            "localized": {
                "en_US": "Software Engineer"
            }, 
            "preferredLocale": {
                "country": "US", 
                "language": "en"
            }
        }, 
        "lastName": {
            "localized": {
                "en_US": "Smith"
            }, 
            "preferredLocale": {
                "country": "US", 
                "language": "en"
            }
        }
    }, 
    "processedActivity": {
        "moveRecommendation": "urn:li:recommendation:(urn:li:person:5Lvu9VVW1m,335014)", 
        "recommendeeEntity": "urn:li:position:(urn:li:person:Ylpq-RobP9,47050422)"
    }, 
    "processedAt": 1487024076827, 
    "resourceName": "recs", 
    "resourceUri": "/recs"
}