easydata-api 1.3.0__tar.gz → 1.4.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: easydata-api
3
- Version: 1.3.0
3
+ Version: 1.4.0
4
4
  Summary: Official Python client for the EasyData LinkedIn enrichment API
5
5
  Author-email: EasyData Development <dev@easydata.win>
6
6
  License-Expression: MIT
@@ -198,9 +198,15 @@ Operations are attributes: `profiles_enrich`, `profiles_enrich_detailed`,
198
198
 
199
199
  `profiles_enrich_detailed` is `profiles_enrich` plus the optional sections -
200
200
  `include_counts=True` for follower and connection counts,
201
- `include_experience_detail=True` for what each role actually says. Each is one
202
- more request to LinkedIn and costs +0.5 per target, charged only when the
203
- section answered, and at least one of them is required.
201
+ `include_experience_detail=True` for what each role actually says,
202
+ `include_skill_details=True` for endorsement counts, `include_interests=True`
203
+ for what the person follows, and `include_recommendations=True` for written
204
+ recommendations in both directions. Each is one more request to LinkedIn and
205
+ costs +0.5 per target, charged only when the section answered, and at least one
206
+ of them is required.
207
+
208
+ The three list sections come back in three states: absent when you did not ask,
209
+ `[]` when you did and the member has none, and populated otherwise.
204
210
 
205
211
  ## Reference
206
212
 
@@ -177,9 +177,15 @@ Operations are attributes: `profiles_enrich`, `profiles_enrich_detailed`,
177
177
 
178
178
  `profiles_enrich_detailed` is `profiles_enrich` plus the optional sections -
179
179
  `include_counts=True` for follower and connection counts,
180
- `include_experience_detail=True` for what each role actually says. Each is one
181
- more request to LinkedIn and costs +0.5 per target, charged only when the
182
- section answered, and at least one of them is required.
180
+ `include_experience_detail=True` for what each role actually says,
181
+ `include_skill_details=True` for endorsement counts, `include_interests=True`
182
+ for what the person follows, and `include_recommendations=True` for written
183
+ recommendations in both directions. Each is one more request to LinkedIn and
184
+ costs +0.5 per target, charged only when the section answered, and at least one
185
+ of them is required.
186
+
187
+ The three list sections come back in three states: absent when you did not ask,
188
+ `[]` when you did and the member has none, and populated otherwise.
183
189
 
184
190
  ## Reference
185
191
 
@@ -318,6 +318,9 @@ class EasyData:
318
318
  find_emails: bool | None = None,
319
319
  include_counts: bool | None = None,
320
320
  include_experience_detail: bool | None = None,
321
+ include_skill_details: bool | None = None,
322
+ include_interests: bool | None = None,
323
+ include_recommendations: bool | None = None,
321
324
  include_results: bool | None = None,
322
325
  idempotency_key: str | None = None,
323
326
  ) -> Batch:
@@ -331,12 +334,16 @@ class EasyData:
331
334
  entry still appears exactly once, complete, and the batch is not
332
335
  ``completed`` until every one has.
333
336
 
334
- ``include_counts`` and ``include_experience_detail`` are the optional
335
- sections of ``profiles_enrich_detailed`` and are refused with a 400 on
336
- anything else. Each is one more request to LinkedIn and costs +0.5 per
337
- target, charged only when the section actually answered; at least one of
338
- them is required on that operation, because with neither set it is
337
+ The five ``include_*`` flags are the optional sections of
338
+ ``profiles_enrich_detailed`` and are refused with a 400 on anything
339
+ else. Each is one more request to LinkedIn and costs +0.5 per target,
340
+ charged only when the section actually answered; at least one of them
341
+ is required on that operation, because with none set it is
339
342
  ``profiles_enrich``, which returns the same record for less.
343
+
344
+ ``skill_details``, ``interests`` and ``recommendations`` come back in
345
+ three states: absent when you did not ask, ``[]`` when you asked and
346
+ this member has none, and populated otherwise.
340
347
  """
341
348
  if not targets:
342
349
  raise ValueError("targets is empty: a batch needs at least one target")
@@ -346,6 +353,9 @@ class EasyData:
346
353
  webhook_tag=webhook_tag, max_results=max_results, enrich=enrich,
347
354
  find_emails=find_emails, include_counts=include_counts,
348
355
  include_experience_detail=include_experience_detail,
356
+ include_skill_details=include_skill_details,
357
+ include_interests=include_interests,
358
+ include_recommendations=include_recommendations,
349
359
  include_results=include_results)
350
360
 
351
361
  data = self._request(
@@ -367,6 +377,9 @@ class EasyData:
367
377
  find_emails: bool | None = None,
368
378
  include_counts: bool | None = None,
369
379
  include_experience_detail: bool | None = None,
380
+ include_skill_details: bool | None = None,
381
+ include_interests: bool | None = None,
382
+ include_recommendations: bool | None = None,
370
383
  idempotency_key: str | None = None,
371
384
  ) -> SyncResult:
372
385
  """One entity, answered in this response, at twice the credits.
@@ -389,7 +402,10 @@ class EasyData:
389
402
  body: dict[str, Any] = {"target": target}
390
403
  _put(body, external_id=external_id, max_results=max_results,
391
404
  find_emails=find_emails, include_counts=include_counts,
392
- include_experience_detail=include_experience_detail)
405
+ include_experience_detail=include_experience_detail,
406
+ include_skill_details=include_skill_details,
407
+ include_interests=include_interests,
408
+ include_recommendations=include_recommendations)
393
409
 
394
410
  data = self._request(
395
411
  "POST", path + "/sync", body=body,
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: easydata-api
3
- Version: 1.3.0
3
+ Version: 1.4.0
4
4
  Summary: Official Python client for the EasyData LinkedIn enrichment API
5
5
  Author-email: EasyData Development <dev@easydata.win>
6
6
  License-Expression: MIT
@@ -198,9 +198,15 @@ Operations are attributes: `profiles_enrich`, `profiles_enrich_detailed`,
198
198
 
199
199
  `profiles_enrich_detailed` is `profiles_enrich` plus the optional sections -
200
200
  `include_counts=True` for follower and connection counts,
201
- `include_experience_detail=True` for what each role actually says. Each is one
202
- more request to LinkedIn and costs +0.5 per target, charged only when the
203
- section answered, and at least one of them is required.
201
+ `include_experience_detail=True` for what each role actually says,
202
+ `include_skill_details=True` for endorsement counts, `include_interests=True`
203
+ for what the person follows, and `include_recommendations=True` for written
204
+ recommendations in both directions. Each is one more request to LinkedIn and
205
+ costs +0.5 per target, charged only when the section answered, and at least one
206
+ of them is required.
207
+
208
+ The three list sections come back in three states: absent when you did not ask,
209
+ `[]` when you did and the member has none, and populated otherwise.
204
210
 
205
211
  ## Reference
206
212
 
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "easydata-api"
7
- version = "1.3.0"
7
+ version = "1.4.0"
8
8
  description = "Official Python client for the EasyData LinkedIn enrichment API"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
File without changes
File without changes